【Android - 控件】之MD - RecyclerView的使用
RecyclerView是Android 5.0新特性——Material Design中的一个控件,它将ListView、GridView整合到一起,可以使用极少的代码在ListView、GridView和瀑布流等布局方式之间转换。RecyclerView整体使用的是插件式的方式,解耦度相比提高了不少,非常灵活。
RecyclerView之所以叫RecyclerView,是因为它的特性:它不关心Item是否显示在正确的位置上;不关心Item间如何分隔;不关心增加与删除的动画效果,只关心如何回收和复用View。
RecyclerView可以实现的Item布局方式:
- 类似ListView的样式(横、纵都可以实现)
- 类似GridView的样式(横、纵都可以实现)
- 瀑布流样式(交错布局)
RecyclerView中可能用到的类:
- LayoutManager:用来管理RecyclerView中的Item的布局方式
- ItemDecoration:用来绘制RecyclerView中Item之间的间隔
- ItemAnimation:用来绘制RecyclerView中的各种动画
- RecyclerView.ViewHolder:用来存放每个Item中的控件
- RecyclerView.Adapter:RecyclerView的适配器类的父类
1、RecyclerView适配数据:
RecyclerView适配数据的方法和ListView、GridView使用的BaseAdapter适配数据的方法不太相同,RecyclerView内部提供了一个ViewHolder用来盛放item中出现的控件,相当于BaseAdapter中我们自己定义的ViewHolder相同,从这可以看出,从RecyclerView开始,Android开始“逼”我们对Item进行回收和复用;RecyclerView内部还提供了一个Adapter,其中有三个抽象方法:
- getItemCount():获取Item的个数
- onCreateViewHolder():返回当前Item的ViewHolder
- onBindViewHolder():向ViewHolder中适配数据
说了这么多,下面贴一下RecyclerView的适配器类RecyclerAdaper中的代码:
public class RecyclerAdapter extends RecyclerView.Adapter<RecyclerAdapter.MyViewHolder> { private Context context; private List<String> data; private LayoutInflater inflater; public RecyclerAdapter(Context context, List<String> data, boolean isStagger, OnRecyclerViewItemOperationListener listener) { this.context = context; this.data = data; this.inflater = LayoutInflater.from(context); } @Override public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { View view = inflater.inflate(R.layout.recycleritem_item, parent, false); return new MyViewHolder(view); } @Override public void onBindViewHolder(final MyViewHolder holder, final int position) { holder.tv.setText(data.get(position)); } @Override public int getItemCount() { return data.size(); } static class MyViewHolder extends RecyclerView.ViewHolder { TextView tv; public MyViewHolder(View itemView) { super(itemView); tv = (TextView) itemView.findViewById(R.id.item_tv); } } }
2、展示模式:
如果是ListView或者GridView,那么直接设置适配器就可以显示数据了,而RecyclerView不行,因为RecyclerView是可以在ListView和GridView,甚至瀑布流之间进行任意切换的,因此我们还需要设置它的布局模式,这里就用到了LayoutManager类。LayoutManager是一个抽象类,我们最常用的子类有两个:LinearLayoutManager(适合线性布局,用于实现ListView的效果)和StaggeredGridLayoutManager(适合格子布局,用于实现GridView或瀑布流的效果)。
我们可以通过RecyclerView对象的setLayoutManager()方法设置它的展示模式:
rv.setLayoutManager(new LinearLayoutManager(MainActivity.this, LinearLayoutManager.VERTICAL, false));
3、分隔线:
这里说的分隔线是RecyclerView的Item之间的分隔线,其实我们大可以不用“正儿八经”的给RecyclerView设置分隔线,因为我们可以使用Item的margin来设置间距,简介实现分隔线的效果。
RecyclerView也给我们提供了一个分隔线的抽象类——ItemDecoration,可以帮助我们实现分隔线,但是Android没有给我们提供这个类的子类,因此,我们需要自己去写。GitHub上有很多大神发布了一些分隔线的类,这里贴出其中一个DividerItemDecoration类来:
public class DividerItemDecoration extends RecyclerView.ItemDecoration { // 系统默认的分隔条的Drawable资源的ID 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; // 绘制Item间间隔的Drawable private Drawable mDivider; // 方向(水平、数值) private int mOrientation; public DividerItemDecoration(Context context, int orientation) { final TypedArray a = context.obtainStyledAttributes(ATTRS); // 获取系统提供的分隔条的Drawable对象 mDivider = a.getDrawable(0); // 回收TypedArray所占用的控件 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) { if (mOrientation == VERTICAL_LIST) { drawVertical(c, parent); } else { drawHorizontal(c, parent); } } /** * 如果设置为纵向列表的样式,则调用这个方法 */ public void drawVertical(Canvas c, RecyclerView parent) { // Item距离左边缘的距离 final int left = parent.getPaddingLeft(); // Item距离右边缘的距离 final int right = parent.getWidth() - parent.getPaddingRight(); // 获取Item的总数 final int childCount = parent.getChildCount(); // 开始绘制所有Item之间的分隔线 for (int i = 0; i < childCount; i++) { final View child = parent.getChildAt(i); RecyclerView v = new RecyclerView(parent.getContext()); final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child.getLayoutParams(); // Item距离上边缘的距离 final int top = child.getBottom() + params.bottomMargin; // Item距离下边缘的距离 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); } } }
这样,我们只需要调用下面这行代码,就可以为RecyclerView设置分隔线了:
// 设置RecyclerView的分隔线 rv.addItemDecoration(new DividerItemDecoration(MainActivity.this, DividerItemDecoration.VERTICAL_LIST));
现在,我们倒回来看一下这个DividerItemDecoration类,其中提到了android.R.attr.listDivider这个属性,这个类中调用的是当前主题中设置的listDivider属性的值,我们可以通过修改主题中的这个属性来达到自定义分隔线的目的。我们只需要自己设计一个分隔线布局,然后在res/styles.xml文件中的AppTheme中添加下面这行代码,就可以实现自定义分隔线了:
<item name="android:listDivider">@drawable/divider_gradient</item>
4、动画:
现在很多APP中都用到了RecyclerView,其中不乏有一些非常炫酷的动画,例如:向下滑动的时候使用动画添加Item、添加Item时候的动画、删除Item时候的动画等。GitHub上也有很多这类动画,大家可以找自己喜欢的动画来设置。
这里用的是系统给我们提供的一种动画——DefaultItemAnimator,我们直接调用下面这行代码,就为RecyclerView设置好了动画。
// 设置RecyclerView的动画效果 rv.setItemAnimator(new DefaultItemAnimator());
这个动画只有添加/删除Item的时候的动画,没有下滑加载Item时候的动画。
5、点击和长按事件:
RecyclerView中没有给我们提供OnClickListener、OnLongClickListener这类接口,因此,我们需要自己写,方法就是使用接口回调。我们可以在Adapter中设置一个接口,里面有点击和长按两个抽象方法,然后在onBindViewHolder()方法中设置Item的View的点击和长按事件,分别回调这两个抽象方法,然后在外界为Adapter对象设置这个接口即可。具体的Adapter的代码如下:
public class RecyclerAdapter extends RecyclerView.Adapter<RecyclerAdapter.MyViewHolder> { private Context context; private List<String> data; private LayoutInflater inflater; private OnRecyclerViewItemOperationListener listener; public RecyclerAdapter(Context context, List<String> data, boolean isStagger, OnRecyclerViewItemOperationListener listener) { this.context = context; this.data = data; this.inflater = LayoutInflater.from(context); this.listener = listener; } @Override public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { View view = inflater.inflate(R.layout.recycleritem_item, parent, false); return new MyViewHolder(view); } @Override public void onBindViewHolder(final MyViewHolder holder, final int position) { holder.itemView.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // 如果不使用这个方法,则获取添加/删除的Item的position会出错 int layoutPosition = holder.getLayoutPosition(); listener.onRecyclerViewItemClickListener(layoutPosition); } }); holder.itemView.setOnLongClickListener(new View.OnLongClickListener() { @Override public boolean onLongClick(View v) { listener.onRecyclerViewItemLongClickListener(holder.getLayoutPosition()); return true; } }); holder.tv.setText(data.get(position)); } @Override public int getItemCount() { return data.size(); } static class MyViewHolder extends RecyclerView.ViewHolder { TextView tv; public MyViewHolder(View itemView) { super(itemView); tv = (TextView) itemView.findViewById(R.id.item_tv); } } public interface OnRecyclerViewItemOperationListener { void onRecyclerViewItemClickListener(int position); void onRecyclerViewItemLongClickListener(int position); } }
6、添加/删除Item:
添加、删除操作主要就是修改适配器绑定的数据源中的数据,加一项或删一项。在RecyclerView中需要注意的是,如果我们为RecyclerView设置了动画,就不能调用Adapter对象的notifyDataSetChanged()方法去更新数据源,因为如果调用notifyDataSetChanged()方法,就没有了动画效果。我们需要调用notifyItemInserted()方法来更新添加Item后的数据源,调用notifyItemRemoved()方法来更新删除Item后的数据源。
另外,在添加了新的Item之后,如果我们调用onBindViewHolder()方法参数中的position,就会出现新添加的Item的position不准确的问题,因此,我们需要使用holder.getLayoutPosition()方法来获取当前Item所在的位置。
最后贴一下我做的一个RecyclerView的小DEMO中的截屏,然后贴源码地址:
下面是码云上的源码地址,供大家参考。