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项目结构如下:

RecyclerView使用介绍_第1张图片

  • 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
"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:id= "@+id/my_recycler_view"
         android:layout_width= "match_parent"
         android:layout_height= "match_parent"
         android:scrollbars= "vertical" />

创建完布局之后在MainActivity中获取这个RecyclerView,并声明LayoutManagerAdapter,代码如下:

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 {
     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 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,等我研究明白了也来讲一讲如何自定义这些效果~

你可能感兴趣的:(RecyclerView使用介绍)