Android RecylerView入门教程
今年google i/0大会,google开放了两个全新的视图:recyclerview和cardview。这篇文章会提供关于recylerview的简介。
recylerview作为support-library发布出来,这对开发者来说绝对是个好消息。因为可以在更低的android版本上使用这个新视图。下面我们看如何获取recylerview。首先打开android sdk manager,然后更新extras->android support library即可。
然后在本地../sdk/extras/android/support/v7中找到recyclerview。我已经将下载好的recyclerview整理成一个eclipse可编译的library工程上传到github,有需求的同学请戳。
示例程序
我将通过recylerview制作一个横向滑动的“listview”,下面是示例程序的截图。并在actionbar上设置数据的添加/删除操作。请同学们注意,recyclerview的接口google可能会继续优化和修改,所以最终的版本可能和我提供的程序有出入。demo程序github链接。
为什么要使用recyclerview?
google在是这样描述recyclerview的:
"a flexible view for providing a limited window into a large data set."
所以recyclerview适用于无法在一个屏幕范围内展现格式一样的数据时,需要用多行或多列来展示。例如展示联系人,图片,视频等。用户需要滑动屏幕来查看数据,这时recyclerview的特性就有用武之地了。比如,当用户滑动使当前一个可视的item滑出屏幕,这个item的视图将会被回收并在一个新item进入可视范围后重新被使用。
如下图所示,用户滑动向上滑动左边的recyclerview,no.0和no.1就会滑出屏幕可视范围,这时右图的no.0和no.1的视图将会被recyclerview放入一个可重复利用的缓存中以备再次使用。
可回收利用view是个很实用的功能,它不仅可以减少cpu不断inflate view的开销,而且可以节省缓存view的内存开销。
这时,你可能会问:这不是一个新功能啊!是的,我们已经在使用listview的时候使用了这个机制,但是当使用listview时,显示,回收等功能是紧密耦合在一起的,google现在发布recyclerview,使方法更灵活,开发者也能自定义各种各样的显示效果。
recyclerview不再负责显示工作
和listview不一样的是,recyclerview不再负责item的摆放等显示方面的功能。所有和布局、绘制等方面的工作google都其拆分成不同的类进行管理。所以开发者可以自定义各种各样满足定制需求的的功能类。
下面是一些和recyclerview相关的非常重要的类列表。
viewholder
关于viewholder,google早就推荐开发者使用,但也只是建议。但是现在,recyclerview.adapter最终要求开发者必须使用viewholder。如果你还对viewholder不了解,请阅读android training session。
demo通过继承recyclerview.viewholder来实现自定义:
public class myviewholder extends viewholder implements onclicklistener,onlongclicklistener{ public imageview iv; public textview tv; private myitemclicklistener mlistener; private myitemlongclicklistener mlongclicklistener; public myviewholder(view rootview,myitemclicklistener listener,myitemlongclicklistener longclicklistener) { super(rootview); iv = (imageview)rootview.findviewbyid(r.id.item_iv); tv = (textview)rootview.findviewbyid(r.id.item_tv); this.mlistener = listener; this.mlongclicklistener = longclicklistener; rootview.setonclicklistener(this); rootview.setonlongclicklistener(this); } /** * 点击监听 */ @override public void onclick(view v) { if(mlistener != null){ mlistener.onitemclick(v,getposition()); } } /** * 长按监听 */ @override public boolean onlongclick(view arg0) { if(mlongclicklistener != null){ mlongclicklistener.onitemlongclick(arg0, getposition()); } return true; } }
recyclerview.adapter
adapter负责扮演两个角色:不仅为底部数据提供支持而且还负责为数据创建合适的视图。adapter适用在android很多控件,例如listview、autocompletetextview等。
继承recyclerview.adapter需要实现以下三个方法:
public viewholder oncreateviewholder(viewgroup parent,int viewtype) public void onbindviewholder(viewholder holder,int position) public int getitemcount() demo中的adapter: [java] view plain copy public class myadapter extends adapter<myviewholder> { private list<myitembean> mdata; private myitemclicklistener mitemclicklistener; private myitemlongclicklistener mitemlongclicklistener; public myadapter(list<myitembean> data){ this.mdata = data; } @override public int getitemcount() { return mdata.size(); } @override public void onbindviewholder(myviewholder holder, int position) { myitembean bean = mdata.get(position); holder.tv.settext(bean.tv); } @override public myviewholder oncreateviewholder(viewgroup parent, int viewtype) { view itemview = layoutinflater.from(parent.getcontext()).inflate(r.layout.item, parent,false); myviewholder vh = new myviewholder(itemview,mitemclicklistener,mitemlongclicklistener); return vh; } }
oncreateviewholder中负责为item创建视图,onbindviewholder负责将数据绑定到item的视图上。
recyclerview.layoutmanager
layoutmanager是recyclerview中最有意思的类。该类负责将每个item视图在recylerview中的布局。目前google提供了layoutmanager的一个子类:linearlayoutmanager。linearlayoutmanager提供了横向和竖向两种布局,demo就是使用linearlayoutmanger的横向布局实现的。
如果要自定义layoutmanager,需要实现一个abstract方法
public layoutparams generatedefaultlayoutparams()
demo中为recylerview添加linearlayoutmanager的片段:
mylayoutmanager manager = new mylayoutmanager(this);
manager.setorientation(linearlayout.horizontal);//默认是linearlayout.vertical
mrecyclerview.setlayoutmanager(manager);
linearlayoutmanager提供了如下几个方法来帮助开发者获取屏幕上的顶部item和底部item:
findfirstvisibleitemposition()
findfirstcompletelyvisibleitemposition()
findlastvisibleitemposition()
findlastcompletelyvisibleitemposition()
recyclerview.itemdecoration
通过itemdecoration可以使各个item在视觉上相互分开,其实和listview的divider很像。itemdecoration并不是recyclerview必须设置的,开发者可以不设置或者设置多个decoration。recyclerview会遍历所有的itemdecoration并调用各自的绘图方法。
继承itemdecoration需要实现以下三个方法:
public void ondraw(canvas c,recyclerview parent,recyclerview.state state)
public void getitemoffset(rect outrect,int itemposition,recyclerview parent)
layoutmanager会调用getitemoffset方法来计算每个item的decoration合适的尺寸。
demo中自定义了一个itemdecoration来实现listview的divider效果:
public class mydecoration extends itemdecoration { private static final int[] attrs = new int[]{ android.r.attr.listdivider }; private drawable mdivider; public mydecoration(context ctx){ final typedarray a = ctx.obtainstyledattributes(attrs); mdivider = a.getdrawable(0); } @override public void ondraw(canvas c, recyclerview parent, state state) { int top = parent.getpaddingtop(); int bottom = parent.getheight() - parent.getpaddingbottom(); int childcount = parent.getchildcount(); for(int i=0;i < childcount;i++){ view child = parent.getchildat(i); recyclerview.layoutparams layoutparams = (recyclerview.layoutparams)child.getlayoutparams(); int left = child.getright() + layoutparams.rightmargin; int right = left + mdivider.getintrinsicwidth(); mdivider.setbounds(left, top, right, bottom); mdivider.draw(c); } } @override public void getitemoffsets(rect outrect, view view, recyclerview parent, state state) { outrect.set(0, 0, mdivider.getintrinsicwidth(), 0); } }
recyclerview.itemanimatior
当item有以下三种操作时itemanimatior会为recyclerview提供动画效果:
删除某一个item
添加一个新的item
移动某个item
google提供了一个名为defaultitemanimator的默认itemanimator供开发者使用。如果开发者不为recyclerview设置itemanimator,recyclerview也会使用默认的defaultitemanimator。
显然,为了让动画效果起效,开发者必须通知adapter数据有改变。之前我们使用adapter时会调用notifydatasetchanged()来通知adapter数据改变并更新视图,现在recyclerview,adapter提供了许多notifyxyz()方法,例如demo中使用了以下两个方法:
public final void notifyiteminserted(int position)
public final void notifyitemremoved(int position)
使用recyclerview
首先,我们先看如何在xml中使用recyclerview
<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="com.xmy.recylerviewdemo.mainactivity" > <android.support.v7.widget.recyclerview android:id="@+id/recyclerview" android:layout_width="wrap_content" android:layout_height="wrap_content"/> </relativelayout>
然后需要开发者在代码中实现recyclerview的组装,大体可概括为以下步骤:
实例化recyclerview
为recyclerview设置layoutmanager
为recyclerview设置adapater
如果有需求,可以设置一个或多个itemdecorations,当然,也可以不设置
如果有需求,可以设置itemanimator