RecyclerView详解之基础使用

RecyclerView基础介绍

android.support.v7.widget.RecyclerView
android.support.v7.widget.LinearLayoutManager
android.support.v7.widget.GridLayoutManager
android.support.v7.widget.StaggeeredGridLayoutManager
android.support.v7.widget.RecyclerView.Adapter
android.support.v7.widget.RecyclerView.ViewHolder
android.support.v7.widget.RecyclerView.LayoutManager
android.support.v7.widget.RecyclerView.ItemDecoration
android.support.v7.widget.RecyclerView.ItemAnimator

RecyclerView和以前的ListView、GridView相比起来，性能上更好，耦合性更低，然而使用起来相对来说复杂度有所增加，在开发中能够使用这个
控件的地方尽量使用。

基本介绍

下面介绍和RecyclerView紧密相关的几个类型：

• 1、LayoutManager，这是控制RecyclerView布局方式的管理类，这是一个抽象类，默认提供的实现有LinearLayoutManager和GridLayoutManager和StaggeeredGridLayoutManager，主要对应于
  线性布局和网格布局方式。效果图如：
  GridLayoutManager：

LinearLayoutManager：

• 2、ItemDecoration，主要用于RecyclerView的分割线，如果需要在RecyclerView中使用分割线就需要继承这个类去自定义。RecyclerView没有提供默认的分割线。
• 3、ItemAnimator，主要用于Item的添加、删除时的动画，需要使用的时候需要继承自这个类去自定义。
• 4、Adapter，这是RecyclerView的一个内部类，作用和平时我们使用的Adapter一样，主要用于RecyclerView的Adapter设置，在往RecyclerView中添加数据时需要继承这个Adapter去实现自己的内容。
• 5、ViewHolder，类似于平时我们使用的Adapter中定义的ViewHolder，在使用RecyclerView的Adapter的时候必须使用该类。

基本用法

1、布局属性

• 1、mst:reverseLayout，取值为true和false。表示布局后Item是否是逆向布局，正常情况下是从上到下，从左到右，设置这个属性后会逆向布局，也就是从下到上，从右到左。
• 2、mst:spanCount，取值为整数。网格布局时网格的列数，该属性只在GridLayoutManager和StaggeeredGridLayoutManager中使用到。
• 3、android:orientation，取值为horizontal或者vertical。表示RecyclerView的布局是横向还是纵向排列，如果是在网格布局中将该属性设置为那么spanCount就表示网格行数。
• 4、mst:layoutManager,通过LayoutManage的完整类名给RecyclerView设置LayoutManager，这样就不用在代码里面设置了。

2、使用方式之初始化

• 1、布局：

    <android.support.v7.widget.RecyclerView         xmlns:android="http://schemas.android.com/apk/res/android"        xmlns:mst="http://schemas.android.com/apk/res-auto"        android:id="@+id/recycler_view"        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:padding="@dimen/main_page_padding"        mst:reverseLayout="false"        mst:orientation="vertical"        mst:layoutManager="@string/recycler_view_linearlayout_manager"        />

• 2、Adapter,自己的Adapter必须继承自RecyclerView.Adapter,这是一个泛型类，具体类型必须是RecyclerView.ViewHolder或者子类。
  Adapter的定义：

class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder> {private ArrayList<String> mData = new ArrayList<String>(); @Override public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType){     MyViewHolder holder = new MyViewHolder(LayoutInflater.from(             mContext).inflate(R.layout.recyclerview_item, parent,             false));     return holder; } @Override public void onBindViewHolder(MyViewHolder holder, int position){     holder.bindData(mData,position); } @Override public int getItemCount() {     return mDatas.size(); }@Overridepublic int getItemViewType(int position){return super.getItemViewType(position);} static class MyViewHolder extends ViewHolder {     TextView text;     public MyViewHolder(View view) {         super(view);         text = (TextView) view.findViewById(android.R.id.text1);     }    public void bindData(ArrayList<String> datas,int position){        text.setText(datas.get(position));    } }}

RecyclerView的初始化：

RecyclerView mList = (RecyclerView)mContentView.findViewById(R.id.recycler_view);mList.setLayoutManager(new LinearLayoutManager(mContext,LinearLayoutManager.VERTICAL,false));mList.setAdapter(new MyAdapter());

3、使用方法之Adapter

Adapter常用方法，RecyclerView的Adapter和以前我们常用的Adapter区别还是挺大的，下面介绍一些常用方法

• 给Item创建一个ViewHolder，其中第一个参数parent是当前RecyclerView，第二个参数是Item的View的类型，可以重写public int getItemViewType(int position)方法，
  然后在onCreateViewHolder中通过返回值去让不同的Item加载不同的View。

public ViewHolder onCreateViewHolder(ViewGroup parent, int itemViewType)

• 在这里绑定Item和数据，其中第一个参数是在onCreateViewHolder返回的ViewHolder，第二个参数是当前Item的position。

public void onBindViewHolder(ViewHolder holder, int position)

• 通过对不同的position返回不同的类型，然后在onCreateViewHolder中通过这里的返回值去加载不同的View

public int getItemViewType(int position)

• 和以前我们用的的notifyDataSetChanged()差不多。调用这个方法会更新所有可见的Item

public final void notifyDataSetChanged()

• 更新指定位置的Item，这样只会更新对应的Item，不会更新所有的Item，避免资源浪费。

public final void notifyItemChanged(int position)

• 更新指定返回内的Item，第一个参数是更新的Item的起始位置，第二个参数是更新的Item的条数，例如，如果需要
  更新从第2条开始的5条Item，可以这样调用这个方法notifyItemRangeChanged（2,5）；

public final void notifyItemRangeChanged(int positionStart, int itemCount) 

• 当新增一个Item的时候调用这个方法去更新新增的Item，不用全部更新。

 public final void notifyItemInserted(int position)

• 调用这个方法去更新从指定起始位置开始的多条Item，用在同时新增多条数据，不需要逐条更新的情况下。

 public final void notifyItemRangeInserted(int positionStart, int itemCount)

• 当删除一条数据的时候调用这个方法去更新删除的Item

public final void notifyItemRemoved(int position)

• 当删除多条数据，不需要逐条更新的时候调用这个方法去更新删除掉的多个Item，从起始位置开始的多条。

 public final void notifyItemRangeRemoved(int positionStart, int itemCount)

4、使用方法之ViewHolder

在使用RecyclerView时需要对Item设置ViewHolder，然后在ViewHolder中进行数据绑定和Item的初始化，这样将数据处理和Adapter进行
解耦：

static class MyViewHolder extends ViewHolder {     TextView text;     public MyViewHolder(View view) {         super(view);         text = (TextView) view.findViewById(android.R.id.text1);     }    public void bindData(ArrayList<String> datas,int position){        text.setText(datas.get(position));    } }

ViewHolder常用方法：

• 构造函数，构造函数的参数就是Item的View，一般在这里初始化Item中的View。

public ViewHolder(View itemView)

• 在Recyclerview 进行添加、移除item等操作时，position位置可能会变化，而所有的adapter的刷新并不总是及时的，只有这个方法返回的才是当前
  item经过一些变换后所处的真正位置。

public final int getLayoutPosition()

• 获得当前Item在Adapter中的位置

public final int getAdapterPosition() 

• 获得当前Item的ViewType

public final int getItemViewType()

• 设置当前Item是否可以被回收

public final void setIsRecyclable(boolean recyclable)

• 查看当前Item是否可以被回收

 public final boolean isRecyclable()

4、使用方法之LayoutManager

LayoutManager主要控制RecyclerView中Item的布局方式，默认提供了如下几个LayoutManager

LinearLayoutManager

LinearLayoutManager使得RecyclerView的布局是线性的，要么垂直布局，要么水平布局。
LinearLayoutManager的常用属性：

• LinearLayoutManager.HORIZONTAL
  如果设置LinearLayoutManager的布局方向为水平的话，RecyclerView的布局就是线性的水平方向上的布局
• LinearLayoutManager.VERTICAL
  如果设置LinearLayoutManager的布局方向为垂直的话，RecyclerView的布局就是线性的垂直方向上的布局

构造函数：

• 默认是垂直布局

public LinearLayoutManager(Context context) 

• 第二个参数代码布局方向，第三个参数代表是否逆向布局

public LinearLayoutManager(Context context, int orientation, boolean reverseLayout)

• 这个构造函数只在RecyclerView布局的时候指定mst:layoutManager时会被调用。

public LinearLayoutManager(Context context, AttributeSet attrs, int defStyleAttr,  int defStyleRes)

常用方法：

• 当LayoutManager不起作用时是否会回收Item

public boolean getRecycleChildrenOnDetach() 

• 设置当LayoutManager和RecyclerView脱离关系的时候是否会回收Item

public void setRecycleChildrenOnDetach(boolean recycleChildrenOnDetach)

• 设置/获取布局方向

public void setOrientation(int orientation) ；public int getOrientation()；

• 设置/获取是否逆向布局

public void setReverseLayout(boolean reverseLayout) ；public boolean getReverseLayout()

常用方法先介绍这些，其他方法请参考Android官方文档https://developer.android.com/reference/android/support/v7/widget/RecyclerView.html

GridLayoutManager

GridLayoutManager是网格布局。
构造函数：

• 第一个构造函数中第二个参数是网格列数

public GridLayoutManager(Context context, int spanCount)；

• 第二个构造函数参数相对较多，第二个参数是列数，第三个数布局方向，如果orientation为horizontal的话，spanCount表示行数，最后一个参数表示是否逆向布局

public GridLayoutManager(Context context, int spanCount, int orientation,            boolean reverseLayout) 

• 第三个构造函数主要用于从RecyclerView的布局中指定LayoutManager时使用

public GridLayoutManager(Context context, AttributeSet attrs, int defStyleAttr,                             int defStyleRes) 

常用方法：

• 设置每一个Item的跨度，通过这个方法可以设置Item的跨度，默认Item跨度为1，数值越大，跨度越大，例如

默认情况：这种情况下spanCount为2，跨度为1

设置了自定义SpanSizeLookup：spanCount同样为2，但是图中的SpanSizeLookup是3, 2, 1, 3, 2, 1，3,2,1….这样排列
的，可以看到显示效果的不同。

public void setSpanSizeLookup(SpanSizeLookup spanSizeLookup)

其中第一个参数SpanSizeLookup是GridLayoutManager的一个内部抽象类，如果要使用的话需要去继承这个类，并
实现public int getSpanSize(int position)，在这里返回SpanSizeLookup的数值。例如：

  public static final class MySpanSizeLookup extends SpanSizeLookup {        @Override        public int getSpanSize(int position) {            return 2;        }    }

• 设置/获取列数

public void setSpanCount(int spanCount) ;public int getSpanCount();

• 最后是GridLayoutManager是继承自LinearLayoutManager的，部分方法和LinearLayoutManager的一样。

StaggeredGridLayoutManager

StaggeredGridLayoutManager可以实现瀑布流形式的布局，如下图是一个列数为2的垂直方向上的瀑布流：

构造函数：

• 第一个构造函数，第一个参数是列数，第二个参数是布局方向，取值为StaggeredGridLayoutManager.VERTICAL和StaggeredGridLayoutManager.HORIZONTAL

public StaggeredGridLayoutManager(int spanCount, int orientation)；

• 第二个构造函数,在从RecyclerView的布局中指定时使用。

public StaggeredGridLayoutManager(Context context, AttributeSet attrs, int defStyleAttr,            int defStyleRes)

常用方法：

• 设置列数

public void setSpanCount(int spanCount)

• 设置布局方向，取值为StaggeredGridLayoutManager.VERTICAL和StaggeredGridLayoutManager.HORIZONTAL

public void setOrientation(int orientation)

• 设置逆向布局

public void setReverseLayout(boolean reverseLayout) 

• 瀑布边缘控制策略，在StaggeredGridLayoutManager的使用中，每一个布局的都会有一个布局边缘，当滑动状态变为SCROLL_STATE_IDLE的时候，StaggeredGridLayoutManager会
  检查Item的布局边缘从而更新视图，这样会导致Item位置发生变化，为了解决这个问题，可以使用边缘策略方法

 public void setGapStrategy(int gapStrategy)；

取值为：StaggeredGridLayoutManager.GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS
和StaggeredGridLayoutManager.GAP_HANDLING_NONE

• 获得Adapter中最先可见的Item的position，这个位置不受布局方向或者是否逆向布局的影响，返回的是Item在Adapter中的位置

public int[] findFirstVisibleItemPositions(int[] into)