RecyclerView使用介绍

来源 http://jinyudong.com/2014/11/13/Introduce-RecyclerView-%E4%B8%80/

这篇文章是根据官网的一篇文章（这里）写的，不过作者增加了一些自己的理解，我十分推崇这种方式，而不是死板的翻译官网的文档，国内技术文章翻译的最差的地方在于：翻译出来的句子还保留着英语的语序。

RecyclerView 是Android L版本中新添加的一个用来取代ListView的SDK，它的灵活性与可替代性比listview更好。接下来通过一系列的文章讲解如何使用RecyclerView,彻底抛弃ListView.

介绍

RecyclerView与ListView原理是类似的：都是仅仅维护少量的View并且可以展示大量的数据集。RecyclerView用以下两种方式简化了数据的展示和处理:

• 使用LayoutManager来确定每一个item的排列方式。

• 为增加和删除项目提供默认的动画效果。

你也可以定义你自己的LayoutManager和添加删除动画，RecyclerView项目结构如下：

• Adapter：使用RecyclerView之前，你需要一个继承自RecyclerView.Adapter的适配器，作用是将数据与每一个item的界面进行绑定。

• LayoutManager：用来确定每一个item如何进行排列摆放，何时展示和隐藏。回收或重用一个View的时候，LayoutManager会向适配器请求新的数据来替换旧的数据，这种机制避免了创建过多的View和频繁的调用findViewById方法（与ListView原理类似）。

目前SDK中提供了三种自带的LayoutManager:

• LinearLayoutManager

• GridLayoutManager

• StaggeredGridLayoutManager

第一节、简单的RecyclerView使用方法

本节所示示例是一个最简单的使用方法，在接下来几节中将会介绍更多RecyclerView的别的一些屌爆的用法。作者用的环境是Android Studio 0.8.6。

1、添加依赖

在AS的build.gradle中添加依赖，然后同步一下就可以引入依赖包：

1 2 3 4

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

2、编写代码

添加完依赖之后，就开始写代码了，与ListView用法类似，也是先在xml布局文件中创建一个RecyclerView的布局：

1 2 3 4 5 6 7 8 9 10 11

<RelativeLayout xmlns:android= "http://schemas.android.com/apk/res/android"      xmlns:tools= "http://schemas.android.com/tools"      android:layout_width= "match_parent"      android:layout_height= "match_parent"      tools:context= ".MainActivity" >      <android.support.v7.widget.RecyclerView          android:id= "@+id/my_recycler_view"          android:layout_width= "match_parent"          android:layout_height= "match_parent"          android:scrollbars= "vertical" /> </RelativeLayout>

创建完布局之后在MainActivity中获取这个RecyclerView，并声明LayoutManager与Adapter，代码如下：

1 2 3 4 5 6 7 8 9

mRecyclerView = (RecyclerView)findViewById(R.id.my_recycler_view); //创建默认的线性LayoutManager mLayoutManager =  new  LinearLayoutManager( this ); mRecyclerView.setLayoutManager(mLayoutManager); //如果可以确定每个item的高度是固定的，设置这个选项可以提高性能 mRecyclerView.setHasFixedSize( true ); //创建并设置Adapter mAdapter = newMyAdapter(getDummyDatas()); mRecyclerView.setAdapter(mAdapter);

接下来的问题就是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

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {      public String[] datas =  null ;      public MyAdapter(String[] datas) {          this .datas = datas;      }      //创建新View，被LayoutManager所调用      @Override      public ViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) {          View view = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item,viewGroup, false );          ViewHolder vh =  new  ViewHolder(view);          return  vh;      }      //将数据与界面进行绑定的操作      @Override      public void onBindViewHolder(ViewHolder viewHolder, int position) {          viewHolder.mTextView.setText(datas[position]);      }      //获取数据的数量      @Override      public int getItemCount() {          return  datas.length;      }      //自定义的ViewHolder，持有每个Item的的所有界面元素      public static class ViewHolder extends RecyclerView.ViewHolder {          public TextView mTextView;          public ViewHolder(View view){          super (view);              mTextView = (TextView) view.findViewById(R.id.text);          }      } }

3、运行

写完这些代码这个例子既可以跑起来了。从例子也可以看出来，RecyclerView的用法并不比ListView复杂，反而更灵活好用，它将数据、排列方式、数据的展示方式都分割开来，因此可定制型，自定义的形式也非常多，非常灵活。

横向布局

如果想要一个横向的List只要设置LinearLayoutManager如下就行，注意要声明mLayoutManager的类型是LinearLayoutManager而不是父类LayoutManager：

1	mLayoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);

Grid布局

如果想要一个Grid布局的列表，只要声明LayoutManager为GridLayoutManager即可：

1 2	mLayoutManager =  new  GridLayoutManager(context,columNum); mRecyclerView.setLayoutManager(mLayoutManager);

注意，在Grid布局中也可以设置列表的Orientation属性，来实现横向和纵向的Grid布局。

瀑布流布局

瀑布流就使用StaggeredGridLayoutManager吧，具体方法与上面类似，就不做介绍啦。

总结

本节介绍的是一个最最简单的RecyclerView的使用方法，后面将介绍一些更高级的用法。

第二节、RecyclerView的高级方法

当使用了一段时间的RecyclerView，发现为其每一项添加点击事件并没有ListView那么轻松，像ListView直接加个OnItemClickListener就行了。实际上我们不要把RecyclerView当做ListView的一个升级版，希望大家把他看做一个容器，同时里面包含了很多不同的Item，它们可以以不同方式排列组合，非常灵活，点击方式你可以按照你自己的意愿进行实现。

本节主要讲解如何为RecyclerView添加点击事件, 并简单介绍如何进行Item增加删除。

添加点击事件

上一节中我们讲了如何使用RecyclerView的Adpater，其实我们会发现，Adapter是添加点击事件一个很好的地方，里面是构造布局等View的主要场所，也是数据和布局进行绑定的地方。首先我们在Adapter中创建一个实现点击接口，其中view是点击的Item，data是我们的数据，因为我们想知道我点击的区域部分的数据是什么，以便我下一步进行操作：

1 2 3

public static interface OnRecyclerViewItemClickListener {      void onItemClick(View view , DataModel data); }

定义完接口，添加接口和设置Adapter接口的方法：

1 2 3 4

private OnRecyclerViewItemClickListener mOnItemClickListener =  null ;      public void setOnItemClickListener(OnRecyclerViewItemClickListener listener) {      this .mOnItemClickListener = listener; }

那么这个接口用在什么地方呢？如下代码所示，我们为Adapter实现OnClickListener方法：

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

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> implements View.OnClickListener{      @Override      public ViewHolder onCreateViewHolder(ViewGroup viewGroup, final int i) {          View view = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item, viewGroup,  false );          ViewHolder vh =  new  ViewHolder(view);          //将创建的View注册点击事件          view.setOnClickListener( this );          return  vh;      }      @Override      public void onBindViewHolder(ViewHolder viewHolder, final int i) {          viewHolder.mTextView.setText(datas.get(i).title);          //将数据保存在itemView的Tag中，以便点击时进行获取          viewHolder.itemView.setTag(datas.get(i));      }      ...      @Override      public void onClick(View v) {          if  (mOnItemClickListener !=  null ) {              //注意这里使用getTag方法获取数据              mOnItemClickListener.onItemClick(v,(DataModel)v.getTag());          }      }      ... }

做完这些事情，我们就可以在Activity或其他地方为RecyclerView添加项目点击事件了，如在MainActivity中：

1 2 3 4 5 6 7 8

mAdapter =  new  MyAdapter(getDummyDatas()); mRecyclerView.setAdapter(mAdapter); mAdapter.setOnItemClickListener( new  MyAdapter.OnRecyclerViewItemClickListener() {      @Override      public void onItemClick(View view, DataModel data) {          //DO your fucking bussiness here!      } });

完成了以上代码就可以为RecyclerView添加项目点击事件了，下面我们来看看RecyclerView如何添加和删除数据并在界面上显示。

添加删除数据

以前在ListView当中，我们只要修改后数据用Adapter的notifyDatasetChange一下就可以更新界面。然而在RecyclerView中还有一些更高级的用法：

添加数据：

1 2 3 4

public void addItem(DataModel content, int position) {      datas.add(position, content);      notifyItemInserted(position);  //Attention! }

删除数据：

1 2 3 4 5

public void removeItem(DataModel model) {      int position = datas.indexOf(model);      datas.remove(position);      notifyItemRemoved(position); //Attention! }

值得注意的是RecyclerView的添加删除都是有默认的动画效果的，如果没有效果可以添加如下代码：

1	mRecyclerView.setItemAnimator(newDefaultItemAnimator());

当然啦你也可以自己定义你自己的Animator，等我研究明白了也来讲一讲如何自定义这些效果~