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、布局：

?

1

2

3

     

 

</android.support.v7.widget.recyclerview>

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

?

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

classMyAdapter extendsRecyclerView.Adapter<myadapter.myviewholder> {

 

privateArrayList<string> mData = newArrayList<string>();

 

 @Override

 publicMyViewHolder onCreateViewHolder(ViewGroup parent, intviewType){

     MyViewHolder holder = newMyViewHolder(LayoutInflater.from(

             mContext).inflate(R.layout.recyclerview_item, parent,

             false));

     returnholder;

 }

 

 @Override

 publicvoid onBindViewHolder(MyViewHolder holder, intposition){

     holder.bindData(mData,position);

 }

 

 @Override

 publicint getItemCount() {

     returnmDatas.size();

 }

@Override

publicint getItemViewType(intposition){

 

returnsuper.getItemViewType(position);

}

 

 staticclass MyViewHolder extendsViewHolder {

     TextView text;

 

     publicMyViewHolder(View view) {

         super(view);

         text = (TextView) view.findViewById(android.R.id.text1);

     }

    publicvoid bindData(ArrayList<string> datas,intposition){

        text.setText(datas.get(position));

    }

 

 }

}

</string></string></string></myadapter.myviewholder>

RecyclerView的初始化：

?

1

2

3

RecyclerView mList = (RecyclerView)mContentView.findViewById(R.id.recycler_view);

mList.setLayoutManager(newLinearLayoutManager(mContext,LinearLayoutManager.VERTICAL,false));

mList.setAdapter(newMyAdapter());

3、使用方法之Adapter

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

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

?

1

publicViewHolder onCreateViewHolder(ViewGroup parent, intitemViewType)

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

?

1

publicvoid onBindViewHolder(ViewHolder holder, intposition)

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

?

1

publicint getItemViewType(intposition)

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

?

1

publicfinal void notifyDataSetChanged()

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

?

1

publicfinal void notifyItemChanged(intposition)

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

?

1

publicfinal void notifyItemRangeChanged(intpositionStart, intitemCount)

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

?

1

publicfinal void notifyItemInserted(intposition)

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

?

1

publicfinal void notifyItemRangeInserted(intpositionStart, intitemCount)

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

?

1

publicfinal void notifyItemRemoved(intposition)

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

?

1

publicfinal void notifyItemRangeRemoved(intpositionStart, intitemCount)

4、使用方法之ViewHolder

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

?

1

2

3

4

5

6

7

8

9

10

11

12

staticclass MyViewHolder extendsViewHolder {

     TextView text;

 

     publicMyViewHolder(View view) {

         super(view);

         text = (TextView) view.findViewById(android.R.id.text1);

     }

    publicvoid bindData(ArrayList<string> datas,intposition){

        text.setText(datas.get(position));

    }

 

 }</string>

ViewHolder常用方法：

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

?

1

publicViewHolder(View itemView)

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

?

1

publicfinal int getLayoutPosition()

获得当前Item在Adapter中的位置

?

1

publicfinal int getAdapterPosition()

获得当前Item的ViewType

?

1

publicfinal int getItemViewType()

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

?

1

publicfinal void setIsRecyclable(booleanrecyclable)

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

?

1

publicfinal boolean isRecyclable()

4、使用方法之LayoutManager

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

LinearLayoutManager

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

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

构造函数：

默认是垂直布局

?

1

publicLinearLayoutManager(Context context)

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

?

1

publicLinearLayoutManager(Context context, intorientation, booleanreverseLayout)

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

?

1

publicLinearLayoutManager(Context context, AttributeSet attrs, intdefStyleAttr,  intdefStyleRes)

常用方法：

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

?

1

publicboolean getRecycleChildrenOnDetach()

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

?

1

publicvoid setRecycleChildrenOnDetach(booleanrecycleChildrenOnDetach)

设置/获取布局方向

?

1

2

publicvoid setOrientation(intorientation) ；

publicint getOrientation()；

设置/获取是否逆向布局

?

1

2

publicvoid setReverseLayout(booleanreverseLayout) ；

publicboolean getReverseLayout()

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

GridLayoutManager

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

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

?

1

publicGridLayoutManager(Context context, intspanCount)；

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

?

1

2

publicGridLayoutManager(Context context, intspanCount, intorientation,

            booleanreverseLayout)

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

?

1

2

publicGridLayoutManager(Context context, AttributeSet attrs, intdefStyleAttr,

                             intdefStyleRes)

常用方法：

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

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

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

?

1

publicvoid setSpanSizeLookup(SpanSizeLookup spanSizeLookup)

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

?

1

2

3

4

5

6

7

8

publicstatic final class MySpanSizeLookup extendsSpanSizeLookup {

 

      @Override

      publicint getSpanSize(intposition) {

          return2;

      }

 

  }

设置/获取列数

?

1

2

publicvoid setSpanCount(intspanCount) ;

publicint getSpanCount();

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

StaggeredGridLayoutManager

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

构造函数：

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

?

1

publicStaggeredGridLayoutManager(intspanCount, intorientation)；

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

?

1

2

publicStaggeredGridLayoutManager(Context context, AttributeSet attrs, intdefStyleAttr,

            intdefStyleRes)

常用方法：

设置列数

?

1

publicvoid setSpanCount(intspanCount)

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

?

1

publicvoid setOrientation(intorientation)

设置逆向布局

?

1

publicvoid setReverseLayout(booleanreverseLayout)

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

?

1

publicvoid setGapStrategy(intgapStrategy)；

取值为：StaggeredGridLayoutManager.GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS
和StaggeredGridLayoutManager.GAP_HANDLING_NONE

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

?

1

publicint[] findFirstVisibleItemPositions(int[] into)