1 Introduction
android.support.v7.recyclerview
在Android 5.0之后,Google推出RecyclerView来取代ListView。官方是这样介绍的:
A flexible view for providing a limited window into a large data set.
和ListView一样,RecyclerView用于显示列表形式的界面,并且通过复用View的方式来节约系统资源,甚至和ListView一样通过Adapter来渲染数据。那么我们为什么要使用RecyclerView呢?自然要说下,二者的区别:
- RecyclerView自动地帮我们实现了itemView的重复利用,而强制开发者去继承
RecyclerView.ViewHolder
来实现一个ViewHolder来管理与itemView相关的位置信息及其他数据。 - RecyclerView必须设置各种
LayoutManager
来实现GridView、ListView甚至瀑布流的效果。 - ListView拥有
android:divider
属性轻松实现条目之间的统一分隔线,而RecyclerView需要一个RecyclerView.ItemDecoration
对象来设置各种各样的分隔线。可以达到不同条目不同分隔线的效果,而不是像ListView那样只能通过将分隔线写进itemView布局的方式来实现。 - ListView没有提供方法来控制添加/删除条目时的动画,而RecyclerView有
RecyclerView.ItemAnimator
来控制条目动画。 - ListView拥有
AdapterView.OnItemClickListener
来处理每个条目的点击事件。而RecyclerView只有RecyclerView.OnItemTouchListener
来处理MotionEvent,而并没有一个内置的点击事件处理。 - 当列表数据发生改变时,ListView只有一个
notifyDataSetChanged()
方法来刷新所有条目。而RecyclerView提供了notifyItemChanged()
、notifyItemInserted()
、notifyItemRemoved()
、notifyDataSetChanged()
等方法,内部实现了局部刷新,更加高效。
所以由上面几点可以看出,RecyclerView可以实现和ListView一样的界面,但是比ListView要灵活得多,同时其内部自动实现了itemView的重用。灵活的代价意味着开发者在配置控件时需要做更多工作,RecyclerView的分隔线、点击事件分发、条目动画都要自己去实现,所以本文就推荐一些好用的RecyclerView轮子。
2 万能分隔线RecyclerView-FlexibleDivider
yqritc/RecyclerView-FlexibleDivider
框架提供了HorizontalDividerItemDecoration
和VerticalDividerItemDecoration
分别对应水平/竖直的divider。
通过Builder的方式构造分隔线,你可以很方便地设置分隔线的margin、颜色、粗细甚至图案:
recyclerView.addItemDecoration(
new HorizontalDividerItemDecoration.Builder(this)
.color(Color.RED)
.sizeResId(R.dimen.divider)
.marginResId(R.dimen.leftmargin, R.dimen.rightmargin)
.build());
也可以通过实现各种Provider
接口,来设置不同位置不同样式的分隔线:
recyclerView.addItemDecoration(new HorizontalDividerItemDecoration.Builder(this)
.sizeProvider(new FlexibleDividerDecoration.SizeProvider(){
@Override
public int dividerSize(int position, RecyclerView parent) {
switch (position % 10) {//不同位置不同高度
case 0:
return 30;
case 1:
return 10;
default:
return 2+position;
}
}
})
.build());
3 各式各样的ItemAnimator实现
gabrielemariotti/RecyclerViewItemAnimators
提供包括SlideInOutLeftItemAnimator 、SlideInOutRightItemAnimator 、SlideInOutTopItemAnimator 、SlideInOutBottomItemAnimator 、ScaleInOutItemAnimator 在内的各种自定义条目动画效果的实现。
- 单个条目的动画设置:
mRecyclerView.setItemAnimator(new SlideInOutLeftItemAnimator(mRecyclerView));
- 整个列表的动画设置:
mAdapter = new MyAdapter(this);
//通过AlphaAnimatorAdapter来包装 原来的列表adapter
AlphaAnimatorAdapter animatorAdapter = new AlphaAnimatorAdapter(mAdapter, mRecyclerView);
mRecyclerView.setAdapter(animatorAdapter);
4 支持复杂的多类型列表视图
drakeet/MultiType
项目中经常会需要写一个复杂的、多 itemView types 的列表视图,经常要做一堆繁琐的工作,而且不小心的话代码还堆积严重:我们需要覆写RecyclerView.Adapter的 getItemViewType()
方法,并新增一些 type 整形常量,而且 ViewHolder继承、泛型传递、转型也比较糟糕。
通过这个库可以轻松简单地实现包含多种不同类型条目的列表:
- 列表中的数据必须实现
Item
接口 - 创建一个类继承
ItemViewProvider
,里面指定了某个Item Type的布局和这个条目对应的RecyclerView.ViewHolder
。 - 在Application 中进行注册类型:
public class App extends Application {
@Override public void onCreate() {
super.onCreate();
MultiTypePool.register(TextItem.class, new TextItemViewProvider());
MultiTypePool.register(ImageItem.class, new ImageItemViewProvider());
}
}
- 然后创建
MultiTypeAdapter
,将数据集合(实现Item
接口的javaBean的集合)设置进去即可。
recyclerView.setAdapter(new MultiTypeAdapter(items));
十分简单优雅有木有?!
类似的还有sockeqwe/AdapterDelegates
5 点击事件的分发
RecyclerView并没有提供一个OnItemClickListener
给开发者去处理条目的点击事件。最简单的办法是自己写个回调接口,然后给itemView设置onClick时去触发这个回调接口。
RecyclerView无法添加onItemClickListener最佳的高效解决方案这篇文章通过 recyclerView.addOnItemTouchListener()
和系统提供的 GestureDetector
手势判断结合实现的。总感觉把简单的问题复杂化了。
这里有一个简单的工具类可以方便实现: ItemClickSupport decorator,使用起来十分简单:
ItemClickSupport.addTo(mRecyclerView).setOnItemClickListener(
new ItemClickSupport.OnItemClickListener() {
@Override
public void onItemClicked(RecyclerView recyclerView, int position, View v) {
// do something.
}
});
6 对Adapter的一些封装
避免自定义Adapter时造成过多的重复代码。且通过装饰者模式优雅地为RecyclerView添加header或者footer:
hongyangAndroid/baseAdapter
主要是在项目中使用RecyclerView.Adapter可以参考这个开源框架的一些思路,做一些优雅的封装。