1. 程式人生 > >這是一篇Android RecyclerView使用介紹哦

這是一篇Android RecyclerView使用介紹哦


RecyclerView三種自帶佈局

RecyclerView是support.v7包中的控制元件,可以說是ListView和GridView的增強升級版。

官方對RecyclerView的描述是(不翻譯不是因為我英語差啊,真的):

A flexible view for providing a limited window into a large data set.

RecyclerView從2014年釋出到現在已經很長時間了,使用已經相當普遍。

本文主要介紹了RecyclerView的基礎使用、自動載入更多資料、item的拖拽和划動刪除。詳細效果和使用請看我的demo;

RecyclerView基礎用法

RecyclerView的用法和ListView類似。我用網格佈局為例,先上程式碼再細說。

首先在佈局中要建立這個控制元件:

    <?xml version="1.0" encoding="utf-8"?>
 <android.support.design.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/grid_coordinatorLayout" android:layout_width="match_parent" android:layout_height="match_parent" android:fitsSystemWindows="true" android:background="#ffffff" tools:context="com.zcp.recyclerviewddmo.GridActivity">
<!--工具欄--> <android.support.design.widget.AppBarLayout android:layout_width
="match_parent" android:layout_height="wrap_content" android:theme="@style/AppTheme.AppBarOverlay">
<android.support.v7.widget.Toolbar android:id="@+id/toolbar" android:layout_width="match_parent" android:layout_height="?attr/actionBarSize" android:background="?attr/colorPrimary" /> </android.support.design.widget.AppBarLayout> <!--下拉重新整理控制元件--> <android.support.v4.widget.SwipeRefreshLayout android:id="@+id/grid_swipe_refresh" android:layout_width="match_parent" android:layout_height="match_parent" app:layout_behavior="@string/appbar_scrolling_view_behavior" > <!--本文主角--> <android.support.v7.widget.RecyclerView android:id="@+id/grid_recycler" android:layout_width="match_parent" android:layout_height="match_parent" /> </android.support.v4.widget.SwipeRefreshLayout> </android.support.design.widget.CoordinatorLayout>

Activity的程式碼如下:

public class GridActivity extends AppCompatActivity {

private static RecyclerView recyclerview;
private CoordinatorLayout coordinatorLayout;
private GridAdapter mAdapter;
private List<Meizi> meizis;
private GridLayoutManager mLayoutManager;
private int lastVisibleItem ;
private int page=1;
private ItemTouchHelper itemTouchHelper;
private SwipeRefreshLayout swipeRefreshLayout;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_grid);
    Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
    setSupportActionBar(toolbar);

    initView();//初始化佈局
    setListener();//設定監聽事件

    //執行載入資料
    new GetData().execute("http://gank.io/api/data/福利/10/1");

}

private void initView(){
    coordinatorLayout=(CoordinatorLayout)findViewById(R.id.grid_coordinatorLayout);

    recyclerview=(RecyclerView)findViewById(R.id.grid_recycler);
    mLayoutManager=new GridLayoutManager(GridActivity.this,3,GridLayoutManager.VERTICAL,false);//設定為一個3列的縱向網格佈局
    recyclerview.setLayoutManager(mLayoutManager);

    swipeRefreshLayout=(SwipeRefreshLayout) findViewById(R.id.grid_swipe_refresh) ;
    //調整SwipeRefreshLayout的位置
    swipeRefreshLayout.setProgressViewOffset(false, 0,  (int) TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 24, getResources().getDisplayMetrics()));
}

private void setListener(){
    //swipeRefreshLayout重新整理監聽
    swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
        @Override
        public void onRefresh() {
            page=1;
            new GetData().execute("http://gank.io/api/data/福利/10/1");
        }
    });
    }


private class GetData extends AsyncTask<String, Integer, String> {

    @Override
    protected void onPreExecute() {
        super.onPreExecute();
        //設定swipeRefreshLayout為重新整理狀態
        swipeRefreshLayout.setRefreshing(true);
    }

    @Override
    protected String doInBackground(String... params) {

        return MyOkhttp.get(params[0]);
    }

    protected void onPostExecute(String result) {
        super.onPostExecute(result);
        if(!TextUtils.isEmpty(result)){

            JSONObject jsonObject;
            Gson gson=new Gson();
            String jsonData=null;

            try {
                jsonObject = new JSONObject(result);
                jsonData = jsonObject.getString("results");
            } catch (JSONException e) {
                e.printStackTrace();
            }
            if(meizis==null||meizis.size()==0){
                meizis= gson.fromJson(jsonData, new TypeToken<List<Meizi>>() {}.getType());

                Meizi pages=new Meizi();
                pages.setPage(page);
                meizis.add(pages);//在資料鏈表中加入一個用於顯示頁數的item
            }else{
                List<Meizi>  more= gson.fromJson(jsonData, new TypeToken<List<Meizi>>() {}.getType());
                meizis.addAll(more);

                Meizi pages=new Meizi();
                pages.setPage(page);
                meizis.add(pages);//在資料鏈表中加入一個用於顯示頁數的item
            }

            if(mAdapter==null){
                recyclerview.setAdapter(mAdapter = new GridAdapter(GridActivity.this,meizis));//recyclerview設定介面卡

                //實現介面卡自定義的點選監聽
                mAdapter.setOnItemClickListener(new GridAdapter.OnRecyclerViewItemClickListener() {
                    @Override
                    public void onItemClick(View view) {
                        int position=recyclerview.getChildAdapterPosition(view);
                        SnackbarUtil.ShortSnackbar(coordinatorLayout,"點選第"+position+"個",SnackbarUtil.Info).show();
                       //彩色Snackbar工具類,請看我之前的文章《沒時間解釋了,快使用Snackbar!——Android Snackbar花式使用指南》http://www.jianshu.com/p/cd1e80e64311
                    }
                    @Override
                    public void onItemLongClick(View view) {

                    }
                });       
            }else{
                //讓介面卡重新整理資料
                mAdapter.notifyDataSetChanged();
            }
        }
        //停止swipeRefreshLayout載入動畫
        swipeRefreshLayout.setRefreshing(false);
    }
}
}

接下來我們看RecyclerView的介面卡:

public  class GridAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> implements View.OnClickListener, View.OnLongClickListener {

private Context mContext;
private List<Meizi> datas;//資料

//自定義監聽事件
public static interface OnRecyclerViewItemClickListener {
    void onItemClick(View view);
    void onItemLongClick(View view);
}
private OnRecyclerViewItemClickListener mOnItemClickListener = null;
public void setOnItemClickListener(OnRecyclerViewItemClickListener listener) {
    mOnItemClickListener = listener;
}

//介面卡初始化
public GridAdapter(Context context,List<Meizi> datas) {
    mContext=context;
    this.datas=datas;
}

@Override
public int getItemViewType(int position) {
    //判斷item類別,是圖還是顯示頁數(圖片有URL)
    if (!TextUtils.isEmpty(datas.get(position).getUrl())) {
        return 0;
    } else {
        return 1;
    }
}

@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType)
{
    //根據item類別載入不同ViewHolder
    if(viewType==0){
        View view = LayoutInflater.from(mContext
                ).inflate(R.layout.grid_meizi_item, parent,
                false);//這個佈局就是一個imageview用來顯示圖片
        MyViewHolder holder = new MyViewHolder(view);

       //給佈局設定點選和長點選監聽
        view.setOnClickListener(this);
        view.setOnLongClickListener(this);

        return holder;
    }else{
        MyViewHolder2 holder2=new MyViewHolder2(LayoutInflater.from(
                mContext).inflate(R.layout.page_item, parent,
                false));//這個佈局就是一個textview用來顯示頁數
        return holder2;
    }

}

@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
 //將資料與item檢視進行繫結,如果是MyViewHolder就載入網路圖片,如果是MyViewHolder2就顯示頁數
    if(holder instanceof MyViewHolder){
        Picasso.with(mContext).load(datas.get(position).getUrl()).into(((MyViewHolder) holder).iv);//載入網路圖片
    }else if(holder instanceof MyViewHolder2){
        ((MyViewHolder2) holder).tv.setText(datas.get(position).getPage()+"頁");
    }

}

@Override
public int getItemCount()
{
    return datas.size();//獲取資料的個數
}

//點選事件回撥
@Override
public void onClick(View v) {
    if (mOnItemClickListener != null) {
        mOnItemClickListener.onItemClick(v);
    }
}
@Override
public boolean onLongClick(View v) {
    if (mOnItemClickListener!= null) {
      mOnItemClickListener.onItemLongClick(v);
   }
    return false;
}

//自定義ViewHolder,用於載入圖片
class MyViewHolder extends RecyclerView.ViewHolder
{
    private ImageButton iv;

    public MyViewHolder(View view)
    {
        super(view);
        iv = (ImageButton) view.findViewById(R.id.iv);
    }
}
//自定義ViewHolder,用於顯示頁數
class MyViewHolder2 extends RecyclerView.ViewHolder
{
    private TextView tv;

    public MyViewHolder2(View view)
    {
        super(view);
        tv = (TextView) view.findViewById(R.id.tv);
    }
}

    //新增一個item
    public void addItem(Meizi meizi, int position) {
        meizis.add(position, meizi);
        notifyItemInserted(position);
        recyclerview.scrollToPosition(position);//recyclerview滾動到新加item處
    }

    //刪除一個item
    public void removeItem(final int position) {
        meizis.remove(position);
        notifyItemRemoved(position);
    }
}

資料類:

 public class Meizi {

private String url;//圖片地址
private int page;//頁數

public String getUrl() {
    return url;
}

public void setUrl(String url) {
    this.url = url;
}

public int getPage() {
    return page;
}

public void setPage(int page) {
    this.page = page;
}  
}

RecyclerView的使用和ListView很像吧。

RecyclerView需要通過setLayoutManager()方法設定佈局管理器,RecyclerView有三個預設佈局管理器LinearLayoutManager、GridLayoutManager、StaggeredGridLayoutManager,都支援橫向和縱向排列以及反向滑動。如果想把RecyclerView改為橫向滑動,也可以通過呼叫

mLayoutManager.setOrientation(GridLayoutManager.HORIZONTAL);

RecyclerView不像ListView一樣提供item的點選監聽,所以我們只能自己實現。RecyclerView的item點選事件監聽可以向我本文中為item的view設定監聽,也可以在recyclerView.addOnItemTouchListener裡去判斷手勢來實現。

通過呼叫如下方法可以設定item載入或移除時的動畫

recyclerView.setItemAnimator(new DefaultItemAnimator());

自動載入更多

要想實現滑動到列表某處時自動載入下一頁(比如剩最後兩個item時),可以通過對RecyclerView設定滑動監聽,獲取當前顯示的最後一個item在介面卡中的位置,如果該item的位置小於或等於介面卡item總個數減2,就載入下一頁資料。
GridLayoutManager和LinearLayoutManager時方法如下:

  //recyclerview滾動監聽
    recyclerview.addOnScrollListener(new RecyclerView.OnScrollListener() {
        @Override
        public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
            super.onScrollStateChanged(recyclerView, newState);
            //0:當前螢幕停止滾動;1時:螢幕在滾動 且 使用者仍在觸碰或手指還在螢幕上;2時:隨使用者的操作,螢幕上產生的慣性滑動;
            // 滑動狀態停止並且剩餘少於兩個item時,自動載入下一頁
            if (newState == RecyclerView.SCROLL_STATE_IDLE
                    && lastVisibleItem +2>=mLayoutManager.getItemCount()) {
                new GetData().execute("http://gank.io/api/data/福利/10/"+(++page));
            }
        }

        @Override
        public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
            super.onScrolled(recyclerView, dx, dy);
            //獲取載入的最後一個可見檢視在介面卡的位置。
            lastVisibleItem = mLayoutManager.findLastVisibleItemPosition();
        }
    });

StaggeredGridLayoutManager因為item的位置是交錯的,findLastVisibleItemPosition()方法返回的是一個數組,所以我們得先判斷下這個陣列的最大值,上面的onScrolled方法寫成這樣

    int[] positions= mLayoutManager.findLastVisibleItemPositions(null);
    lastVisibleItem =Math.max(positions[0],positions[1]);//根據StaggeredGridLayoutManager設定的列數來定

自動載入下一頁.gif


XRecyclerView是別人寫的一個庫,實現了RecyclerView的下拉頭和底部載入佈局,需要的可以看下。

Item拖拽和滑動刪除

ItemTouchHelper是一個處理RecyclerView的滑動刪除和拖拽的輔助類,RecyclerView 的item拖拽移動和滑動刪除就靠它來實現。

ItemTouchHelper的監聽如下

    itemTouchHelper=new ItemTouchHelper(new ItemTouchHelper.Callback() {

        //用於設定拖拽和滑動的方向
        @Override
        public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
            int dragFlags=0,swipeFlags=0;
            if(recyclerView.getLayoutManager() instanceof StaggeredGridLayoutManager||recyclerView.getLayoutManager() instanceof GridLayoutManager){
               //網格式佈局有4個方向
               dragFlags=ItemTouchHelper.UP|ItemTouchHelper.DOWN|ItemTouchHelper.LEFT|ItemTouchHelper.RIGHT;
            }else if(recyclerView.getLayoutManager() instanceof LinearLayoutManager){
               //線性式佈局有2個方向
               dragFlags=ItemTouchHelper.UP|ItemTouchHelper.DOWN;

               swipeFlags = ItemTouchHelper.START|ItemTouchHelper.END; //設定側滑方向為從兩個方向都可以
            }
            return makeMovementFlags(dragFlags,swipeFlags);//swipeFlags 為0的話item不滑動
        }

        //長摁item拖拽時會回撥這個方法
        @Override
        public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
            int from=viewHolder.getAdapterPosition();
            int to=target.getAdapterPosition();

            Meizi moveItem=meizis.get(from);
            meizis.remove(from);
            meizis.add(to,moveItem);//交換資料鏈表中資料的位置

            mAdapter.notifyItemMoved(from,to);//更新介面卡中item的位置
            return true;
        }

        @Override
        public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
        //這裡處理滑動刪除
        }

        @Override
        public boolean isLongPressDragEnabled() {
            return false;//返回true則為所有item都設定可以拖拽
        }
    });

itemTouchHelper需要與recyclerView繫結才有效果,在recyclerView初始化的時候呼叫

     itemTouchHelper.attachToRecyclerView(recyclerview);

因為我想要網格佈局中的圖片item可拖拽,而頁數item不可拖拽,所以我isLongPressDragEnabled()方法返回的false,而在item的長點選事件監聽中做具體處理。

       mAdapter.setOnItemClickListener(new GridAdapter.OnRecyclerViewItemClickListener() {
       @Override
       public void onItemClick(View view) {
       }

        @Override
        public void onItemLongClick(View view) {
              itemTouchHelper.startDrag(recyclerview.getChildViewHolder(view));//設定拖拽item
           }
       });

如果你想為item設定拖拽和滑動時的響應動畫效果,可以利用ItemTouchHelper的下面三個方法。用線性佈局示例:

//當item拖拽開始時呼叫
@Override
public void onSelectedChanged(RecyclerView.ViewHolder viewHolder, int actionState) {
super.onSelectedChanged(viewHolder, actionState);
 if(actionState==ItemTouchHelper.ACTION_STATE_DRAG){
       viewHolder.itemView.setBackgroundColor(Color.LTGRAY);//拖拽時設定背景色為灰色
    }
}

//當item拖拽完成時呼叫
@Override
public void clearView(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
super.clearView(recyclerView, viewHolder);
 viewHolder.itemView.setBackgroundColor(Color.WHITE);//拖拽停止時設定背景色為白色
}

 //當item檢視變化時呼叫
 @Override
 public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dX, float dY, int actionState, boolean isCurrentlyActive) {
 super.onChildDraw(c, recyclerView, viewHolder, dX, dY, actionState, isCurrentlyActive);
  //根據item滑動偏移的值修改item透明度。screenwidth是我提前獲得的螢幕寬度
  viewHolder.itemView.setAlpha(1-Math.abs(dX)/screenwidth);
 }

拖拽和滑動刪除.gif

本文送給說“三百六十行,行行出碼農”,然後來跟我搶飯碗的兩位兄弟。

我知道你們都喜歡看妹子 →_→...

大家覺得本文還行的話請點個贊n(≧▽≦)n