Android新特性之RecyclerView的简单使用

Android新特性之RecyclerView的简单使用

RecyclerView是安卓5.0版本中的一个新控件，目的是来取代使用多年的ListView。RecyclerView的灵活性远超ListView，所以RecyclerView扩展性非常高，下面就让我们一起来看看RecyclerView的简单使用。

简介

RecyclerView的设计非常灵活，它通过LayoutManager、ItemDecoration、ItemAnimator这三个类进行所有的布局控制，绑定数据依旧是使用Adapter进行绑定。所以我们只需要掌握这三个类的使用即可。

环境配置

RecyclerView是android系统提供的新控件，自然按照谷歌的一贯作风，我们需要下载一个支持库。android.support.v7。所以使用该控件，我们需要添加v7包的引用。v7下载地址。

下载完成后，我们需要在开发环境中添加该包的引用。简要介绍在Eclipse和Android Studio中的引用方式。

Eclipse添加V7包

1、在eclipse的工作控件将v7包导入到我们的工程中。注意：此时应将我们下载好的v7包放到我们工程目录下，不然后面导入后会出问题。

2、选中我们的项目，右键properties属性，进入如下图，我们点击add，系统就会在我们的工作目录下，找到Library类库，供我们添加，我们选择v7即可。这样我们就可以使用RecyclerView了。



注意：如果你添加到v7包到eclipse了，但是找不到该library，你选中v7包工程右键属性选择Library，然后勾选上图中的isLibrary，点击确定即可。

AndroidStudio中添加v7包

1、要确保已经将Android Support Libraries升级到最新。

2、打开我们的module对应的build.gradle文件，在dependencies中添加

compile 'com.android.support:recyclerview-v7:21.0.+'

3、重新Build一下工程即可。

相关类介绍

一、RecyclerView

我们打开源码，看到

public class RecyclerView extends ViewGroup

所以这也就是我们常见的自定义ViewGroup，只不过这个玩意比较牛逼罢了。通过源码，我们看到这玩意有很多方法，但是我们仅仅挑选几个常用的来说说。

1、public void setAdapter(Adapter adapter)

根据我们使用的经验，显然这个方法是让我们绑定数据的，只不过这个Adapter是

public static abstract class Adapter<VH extends ViewHolder>

类型的。

2、 public void setLayoutManager(LayoutManager layout)

看到layout开头，显然是跟布局有关，又有manager，所以这个LayoutManager肯定就是负责RecyclerView的布局的类。

3、public void addItemDecoration(ItemDecoration decor, int index)

为每个item附加的子视图，这个方法可用于添加分割线，这点和我们使用ListView的setDivider()有点类似，此时，我们只要传入一个ItemDecoration对象。

4、 public void setItemAnimator(ItemAnimator animator)

这个方法很牛逼，可以设置动画。先来看看官方文档对此方法的注释。

* Sets the {@link ItemAnimator} that will handle animations involving changes
* to the items in this RecyclerView. By default, RecyclerView instantiates and
* uses an instance of {@link DefaultItemAnimator}. Whether item animations are
* enabled for the RecyclerView depends on the ItemAnimator and whether
* the LayoutManager {@link LayoutManager#supportsPredictiveItemAnimations()
* supports item animations}.
*/

这段话的大概意思就是通过此方法设置ItemAnimator对象来实现RecyclerView的item的动画，默认情况下，使用DefaultItemAnimator动画。动画是否有效取决于ItemAnimator和LayoutManager的类对象。

以上就是众多方法中比较常用的四个，这四个方法的灵活性很高，所以也铸就了RecyclerView的高度灵活性，看了上面的四个方法，我们可以肯定RecyclerView类的内部肯定有对应的四个类对象来处理所需的效果。

二、LayoutManager

上面也分析了，这个LayoutManager就是我们的布局管理器。我们下来看看一张类的组织结构图。



我们先来看看该类的定义源码来一睹风采。

public static abstract class LayoutManager

看到源码，吓了一跳，原来是一个抽象类，那我们setLayoutManager(LayoutManager layout)时难道要我们自定义一个LayoutManager对象么？哈哈！不会的，如果真是那样，我估计RecyclerView就变的极其复杂了，为什么？且看源码对该类的注释。

/**
* A <code>LayoutManager</code> is responsible for measuring and positioning item views
* within a <code>RecyclerView</code> as well as determining the policy for when to recycle
* item views that are no longer visible to the user. By changing the <code>LayoutManager</code>
* a <code>RecyclerView</code> can be used to implement a standard vertically scrolling list,
* a uniform grid, staggered grids, horizontally scrolling collections and more. Several stock
* layout managers are provided for general use.
*/

意思就是：LayoutManager负责RecyclerView中item的测量以及放置，同时也管理着item的回收。通过改变LayoutManager可以让RecyclerView形成垂直滚动的效果(ListView)，统一网格效果(GridView)、交错网格效果(瀑布流)、横向滚动效果(HorizontalListView)等等。

所以说，这么复杂的东西怎么能让开发者完全实现呢？安卓肯定会给我们提供几个实现好的类。

LinearLayoutManager：线性布局管理器，支持横向和纵向形式。

GridLayoutManager： 网格布局管理器。

StaggeredGridLayoutManager：瀑布就式布局管理器

所以在实际开发中，我们可以根据实际需要进行使用，一般情况下，这三个子类能完全满足我们的需求，更高需求，请自定义LayoutManager对象。

三、ItemDecoration

为每个item附加的子视图，这个类可用于我们设置分割线，同样也是RecyclerView类的内部类，那么我们看看它的定义形式：

public static abstract class ItemDecoration

又是一个抽象类，所以注定了它是不平凡的，即我们需要自定义它的子类来实现绚丽的分割效果，官方现在好像还没有吧！以后估计可能有。

四、ItemAnimator

一看，跟Animator沾边，八成就是搞动画的出身。同样该类也是RecyclerView类的内部类，我们看看它的定义吧！

public static abstract class ItemAnimator

所以注定了不平凡有不平凡的伟大，我们需要自定义子类来实现动画，系统也提供默认的。

关于RecyclerView的基本要素，我们简要说了下，总体来说，功能很强大，能玩多6全看自身水平多高，涉及的方面比较多，上手比较容易，想精通这个控件，还是需要下很大功夫的。下面就开始学习使用这个控件了。

RecyclerView的使用

1、基本使用步骤：

View view = inflater.inflate(R.layout.fragment_linear_layout_manager, container, false);
//RecyclerView的初始化
mRecyclerView = (RecyclerView)view.findViewById(R.id.recycler_view);
//创建现行LinearLayoutManager
mLayoutManager = new LinearLayoutManager(getActivity());
//设置LayoutMananger
mRecyclerView.setLayoutManager(mLayoutManager);
//设置item的动画，可以不设置
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
MyAdapter adapter = new MyAdapter(initDate());
//设置Adapter
mRecyclerView.setAdapter(adapter);

以上就是使用的几个步骤，很简单，所以我们就开始学习使用。由于演示功能较多，所以我们采用在Fragment中进行。

ListView效果

1、首先我们创建名称为LinearLayoutManagerFragment的Fragment，用于展示线性的布局，然后创建对应的xml布局。在AndroidStudio中我们创建该fragment时系统已经默认帮我们创建好了，Eclipse中就不会。我们直接看xml布局中的RecyclerView的使用吧！

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<android.support.v7.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scrollbars="vertical"
/>
</FrameLayout>

使用很简单，下面看看我们在Fragment中的使用代码：

public class LinearLayoutManagerFragment extends Fragment {
private RecyclerView mRecyclerView;
private RecyclerView.LayoutManager mLayoutManager;

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fragment_linear_layout_manager, container, false);
//RecyclerView的初始化
mRecyclerView = (RecyclerView)view.findViewById(R.id.recycler_view);
//创建现行LinearLayoutManager
mLayoutManager = new LinearLayoutManager(getActivity());
//设置LayoutMananger
mRecyclerView.setLayoutManager(mLayoutManager);
//设置item的动画，可以不设置
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
MyAdapter adapter = new MyAdapter(initDate());
//设置Adapter
mRecyclerView.setAdapter(adapter);
return view;
}

private List<String> initDate(){
List<String> list = new ArrayList<>();
for(int i=0;i<50;i++){
list.add("测试用例：" + i);
}
return list;
}

class MyAdapter  extends RecyclerView.Adapter<MyAdapter.ViewHolder>{
private List<String> items;

public MyAdapter(List<String> items) {
this.items = items;
}

/**
* 创建ViewHolder的布局
* @param parent
* @param viewType
* @return
*/
@Override
public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item,parent,false);
return new ViewHolder(view);
}

/**
* 通过ViewHolder将数据绑定到界面上进行显示
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
holder.mTextView.setText(items.get(position));
}

@Override
public int getItemCount() {
return items.size();
}

public class ViewHolder extends RecyclerView.ViewHolder{
public TextView mTextView;
public ViewHolder(View itemView) {
super(itemView);
mTextView = (TextView) itemView.findViewById(R.id.textView);
}
}
}
}

item的布局，仅仅包含一个TextView用于展示。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical" android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/textView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:padding="20dp"
android:background="#7fa87f"
android:textColor="#ffffff"
android:gravity="center_horizontal"/>
</LinearLayout>

使用步骤与我们开篇说的一样，其实和ListView的使用差异不大，初始化控件，然后设置控件的相关属性，接着绑定数据，只不Recyclerview的属性设置有些复杂罢了。比较明显的变化就数Adapter的变化了。以前在使用ListView时，我们继承BaseAdapter来自定义Adatper适配器，然后使用ViewHolder进行复用Item。现在我们在看看RecyclerView.Adapter。

public static abstract class Adapter<VH extends ViewHolder>

看到这个类的定义确实吓一跳，Adapter里面都是ViewHolder类型，难道系统有ViewHolder，猜对了，系统中已经带了ViewHolder类型，

public static abstract class ViewHolder

所以我们我们要继承此ViewHolder来自定义我们的ViewHolder。就有了上面的写法，来发效果图！



ok，简单的使用已经完成，我们前面也分析了，RecyclerView可以实现横向的ListView，那么我们来看看效果，我们创建名为HorrizontalManagerFragment的fragment。内容可以完全复制LinearLayoutManagerFragment的内容，只需要做以下几点修改：

private LinearLayoutManager mLayoutManager;
mLayoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);

即可。效果图：



上面的效果实现了，但是感觉是不是很别扭，少了点什么。就是分割线，下面我们来给我们的RecyclerView添加分割线。当我们调用mRecyclerView.addItemDecoration()方法添加decoration的时候，RecyclerView在绘制的时候，去会绘制decorator，即调用该类的onDraw和onDrawOver方法，

onDraw方法先于drawChildren

onDrawOver在drawChildren之后，一般我们选择复写其中一个即可。

getItemOffsets 可以通过outRect.set()为每个Item设置一定的偏移量，主要用于绘制Decorator。

我们建一个包用来放我们的ItemDecoration，我们先找一个现成的例子，来试试。

public class DividerItemDecoration extends RecyclerView.ItemDecoration{
private static final int[] ATTRS = new int[]{
android.R.attr.listDivider
};

public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;

public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;

private Drawable mDivider;

private int mOrientation;

public DividerItemDecoration(Context context, int orientation) {
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
a.recycle();
setOrientation(orientation);
}

public void setOrientation(int orientation) {
if (orientation != HORIZONTAL_LIST && orientation != VERTICAL_LIST) {
throw new IllegalArgumentException("invalid orientation");
}
mOrientation = orientation;
}

@Override
public void onDraw(Canvas c, RecyclerView parent) {
Log.v("recyclerview - itemdecoration", "onDraw()");

if (mOrientation == VERTICAL_LIST) {
drawVertical(c, parent);
} else {
drawHorizontal(c, parent);
}

}

public void drawVertical(Canvas c, RecyclerView parent) {
final int left = parent.getPaddingLeft();
final int right = parent.getWidth() - parent.getPaddingRight();

final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
android.support.v7.widget.RecyclerView v = new android.support.v7.widget.RecyclerView(parent.getContext());
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int top = child.getBottom() + params.bottomMargin;
final int bottom = top + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}

public void drawHorizontal(Canvas c, RecyclerView parent) {
final int top = parent.getPaddingTop();
final int bottom = parent.getHeight() - parent.getPaddingBottom();

final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int left = child.getRight() + params.rightMargin;
final int right = left + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}

@Override
public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {
if (mOrientation == VERTICAL_LIST) {
outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
} else {
outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
}
}
}

在Fragment中只需增加

mRecyclerView.addItemDecoration(new DividerItemDecoration(getActivity(),LinearLayoutManager.VERTICAL));

来看看效果图：



通过上面的实例，线条已经画出来了，我们只需要改变Draw的实例就可以了，所以这个玩的空间就比较大了。比如：

<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle" >
<solid android:color="#00ff00"/>
<corners android:radius="20dp"/>
<size android:height="4dp"/>
</shape>

效果图：



总之不单单添加分割线，其它用处也很多，样式更加随心所欲。

GridView效果

步骤如上，我们只需要更改LayoutManager所指向的对象即可。

mLayoutManager = new GridLayoutManager(getActivity(),4);

这样就能实现一个GridView效果，我们要处理的就是ItemDecrator的处理。

下面引自张鸿洋写的一个效果：

/**
*
* @author zhy
*
*/
public class DividerGridItemDecoration extends RecyclerView.ItemDecoration
{

private static final int[] ATTRS = new int[] { android.R.attr.listDivider };
private Drawable mDivider;

public DividerGridItemDecoration(Context context)
{
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
a.recycle();
}

@Override
public void onDraw(Canvas c, RecyclerView parent, State state)
{

drawHorizontal(c, parent);
drawVertical(c, parent);

}

private int getSpanCount(RecyclerView parent)
{
// 列数
int spanCount = -1;
LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{

spanCount = ((GridLayoutManager) layoutManager).getSpanCount();
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
spanCount = ((StaggeredGridLayoutManager) layoutManager)
.getSpanCount();
}
return spanCount;
}

public void drawHorizontal(Canvas c, RecyclerView parent)
{
int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++)
{
final View child = parent.getChildAt(i);
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int left = child.getLeft() - params.leftMargin;
final int right = child.getRight() + params.rightMargin
+ mDivider.getIntrinsicWidth();
final int top = child.getBottom() + params.bottomMargin;
final int bottom = top + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}

public void drawVertical(Canvas c, RecyclerView parent)
{
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++)
{
final View child = parent.getChildAt(i);

final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int top = child.getTop() - params.topMargin;
final int bottom = child.getBottom() + params.bottomMargin;
final int left = child.getRight() + params.rightMargin;
final int right = left + mDivider.getIntrinsicWidth();

mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}

private boolean isLastColum(RecyclerView parent, int pos, int spanCount,
int childCount)
{
LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{
if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
{
return true;
}
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
int orientation = ((StaggeredGridLayoutManager) layoutManager)
.getOrientation();
if (orientation == StaggeredGridLayoutManager.VERTICAL)
{
if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
{
return true;
}
} else
{
childCount = childCount - childCount % spanCount;
if (pos >= childCount)// 如果是最后一列，则不需要绘制右边
return true;
}
}
return false;
}

private boolean isLastRaw(RecyclerView parent, int pos, int spanCount,
int childCount)
{
LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{
childCount = childCount - childCount % spanCount;
if (pos >= childCount)// 如果是最后一行，则不需要绘制底部
return true;
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
int orientation = ((StaggeredGridLayoutManager) layoutManager)
.getOrientation();
// StaggeredGridLayoutManager 且纵向滚动
if (orientation == StaggeredGridLayoutManager.VERTICAL)
{
childCount = childCount - childCount % spanCount;
// 如果是最后一行，则不需要绘制底部
if (pos >= childCount)
return true;
} else
// StaggeredGridLayoutManager 且横向滚动
{
// 如果是最后一行，则不需要绘制底部
if ((pos + 1) % spanCount == 0)
{
return true;
}
}
}
return false;
}

@Override
public void getItemOffsets(Rect outRect, int itemPosition,
RecyclerView parent)
{
int spanCount = getSpanCount(parent);
int childCount = parent.getAdapter().getItemCount();
if (isLastRaw(parent, itemPosition, spanCount, childCount))// 如果是最后一行，则不需要绘制底部
{
outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
} else if (isLastColum(parent, itemPosition, spanCount, childCount))// 如果是最后一列，则不需要绘制右边
{
outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
} else
{
outRect.set(0, 0, mDivider.getIntrinsicWidth(),
mDivider.getIntrinsicHeight());
}
}
}

效果图：



瀑布流效果

同样，我们只需要修改LayoutManager来实现效果：

mLayoutManager = new StaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL);

效果图：



我们发现，每个item都很整齐，但是瀑布流的效果不是这样的啊！那我们怎么搞，就是在onBindViewHolder方法中修改每个view的大小。

@Override
public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
ViewGroup.LayoutParams params= holder.mTextView.getLayoutParams();
params.height = (int) (100 + Math.random() * 400);
holder.mTextView.setLayoutParams(params);
holder.mTextView.setText(items.get(position));
}

效果图：



至此，所有的展示工作已经完成，那么我们进行点击事件处理。

点击效果处理

RecyclerView没有像ListView有setOnItemClick的事件，那么只有我们通过回调接口进行设置。

public interface OnItemClick {
public void onItemClick(int position);
}

public void setOnItemClick(OnItemClick onItemClick){
this.onItemClick = onItemClick;
}

public void onBindViewHolder(final MyAdapter.ViewHolder holder, int position) {
holder.mTextView.setText(items.get(position));
if(onItemClick != null){
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
onItemClick.onItemClick(holder.getPosition());
}
});
}
}

这样我们就能进行点击事件的处理了。效果图：



至此，关于RecyclerView的基本用法讲解完毕，还是要多练习，比如分割线的处理以及动画的处理，这部分是个亮点也是难点。

源码下载地址

参考文档:

http://www.devstore.cn/new/newInfo/868.html

http://blog.jobbole.com/74208/

http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2014/1118/2004.html

http://blog.csdn.net/lmj623565791/article/details/45059587

http://blog.csdn.net/guxiao1201/article/details/40399777

作者：mr_dsw 欢迎转载，与人分享是进步的源泉！

转载请保留地址：http://blog.csdn.net/mr_dsw