Android控件RecyclerView的基本用法
Android控件RecyclerView的基本用法
前言:虽然在日常开发中已经多次接触过RecycleView,但也只是用到其最基本的功能,并没有深入研究其他内容。接下来将抽出时间去了解RecycleView的相关内容,同时在博客中进行记录,以此加深印象。这篇文章主要是介绍RecycleView的使用方法。
一、RecyclerView是什么
RecycleView是Android5.0后谷歌推出的一个用于在有限的窗口中展示大量数据集的控件,位于support-v7包中。它可以实现与ListView和GridView一样的效果,提供了一种插拔式的体验,高度的解耦,异常的灵活,只需设置其提供的不同的LayoutManager,ItemAnimator和ItemDecoration,就能实现不同的效果。
二、RecyclerView的优点
1、支持局部刷新。
2、可以自定义item增删时的动画。
3、能够实现item拖拽和侧滑删除等功能。
4、默认已实现View的复用,而且回收机制更加完善。
三、RecyclerView的使用方法
首先要在build.gradle文件中添加引用
compile 'com.android.support:recyclerview-v7:26.1.0'
主页面布局:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<android.support.v7.widget.RecyclerView
android:id="@+id/rv_list"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayou>
item布局:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal">
<TextView
android:id="@+id/tv_content"
android:layout_width="match_parent"
android:layout_height="50dp"
android:gravity="center"
android:text="数据" />
</LinearLayout>
adapter代码:
public class MyRecycleViewAdapter extends RecyclerView.Adapter<MyRecycleViewAdapter.MyHolder> {
private List mList;//数据源
MyRecycleViewAdapter(List list) {
mList = list;
}
//创建ViewHolder并返回,后续item布局里控件都是从ViewHolder中取出
@Override
public MyHolder onCreateViewHolder(ViewGroup parent, int viewType) {
//将我们自定义的item布局R.layout.item_one转换为View
View view = LayoutInflater.from(parent.getContext())
.inflate(R.layout.item_one, parent, false);
//将view传递给我们自定义的ViewHolder
MyHolder holder = new MyHolder(view);
//返回这个MyHolder实体
return holder;
}
//通过方法提供的ViewHolder,将数据绑定到ViewHolder中
@Override
public void onBindViewHolder(MyHolder holder, int position) {
holder.textView.setText(mList.get(position).toString());
}
//获取数据源总的条数
@Override
public int getItemCount() {
return mList.size();
}
/**
* 自定义的ViewHolder
*/
class MyHolder extends RecyclerView.ViewHolder {
TextView textView;
public MyHolder(View itemView) {
super(itemView);
textView = itemView.findViewById(R.id.tv_content);
}
}
}
MainActivity代码:
public class MainActivity extends AppCompatActivity {
private RecyclerView mRecycleView;
private MyRecycleViewAdapter mAdapter;//适配器
private LinearLayoutManager mLinearLayoutManager;//布局管理器
private List mList;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mList = new ArrayList();
mRecycleView = findViewById(R.id.rv_list);
//初始化数据
initData(mList);
//创建布局管理器,垂直设置LinearLayoutManager.VERTICAL,水平设置LinearLayoutManager.HORIZONTAL
mLinearLayoutManager = new LinearLayoutManager(this, LinearLayoutManager.VERTICAL, false);
//创建适配器,将数据传递给适配器
mAdapter = new MyRecycleViewAdapter(mList);
//设置布局管理器
mRecycleView.setLayoutManager(mLinearLayoutManager);
//设置适配器adapter
mRecycleView.setAdapter(mAdapter);
}
public void initData(List list) {
for (int i = 1; i <= 40; i++) {
list.add("第" + i + "条数据");
}
}
}
Adapter
使用时需要创建adapter(适配器)类,该类继承于RecyclerView.Adapter<VH>
,其中VH是我们adapter类中创建的一个继承于RecyclerView.ViewHolder
的静态内部类。
可以看到该适配器类主要有3个方法和1个自定义ViewHolder组成:
- onCreateViewHolder: 创建ViewHolder并返回,后续item布局里控件都是从ViewHolder中取出。
- onBindViewHolder:通过方法提供的ViewHolder,将数据绑定到ViewHolder中。
- getItemCount:获取数据源总的条数。
- MyHolder :这是RecyclerView.ViewHolder的实现类,用于初始化item布局中的子控件。需要注意的是,在这个类的构造方法中需要传递item布局的View给父类 。
使用方法:
//设置适配器adapter
mRecycleView.setAdapter(mAdapter);
LayoutManager
布局管理器,通过不同的布局管理器来控制item的排列顺序,负责item元素的布局和复用。RecycleView提供了三种布局管理器:
- LinearLayoutManager:线性布局,以垂直或水平滚动列表方式显示项目。
- GridLayoutManager:网格布局,在网格中显示项目。
- StaggeredGridLayoutManager:瀑布流布局,在分散对齐网格中显示项目。
使用方法:
mRecycleView.setLayoutManager(new LinearLayoutManager(this,
LinearLayoutManager.HORIZONTAL,false));
运行效果:
以上是LinearLayoutManager布局呈现的效果,假如遇到特殊需求,也可以通过继承RecyclerView.LayoutManager
来自定义LayoutManager,重写它的方法来实现所需要的效果。
ItemDecoration
RecyclerView可以通过addItemDecoration()
设置分割线。Android并没有提供实现好的分割线,所以任何的分割线样式都需要用户自己实现。可以通过继承RecyclerView.ItemDecoration
类来实现。
ItemDecoration源码:
public abstract static class ItemDecoration {
public void onDraw(Canvas c, RecyclerView parent, State state) {
onDraw(c, parent);
}
@Deprecated
public void onDraw(Canvas c, RecyclerView parent) {
}
public void onDrawOver(Canvas c, RecyclerView parent, State state) {
onDrawOver(c, parent);
}
@Deprecated
public void onDrawOver(Canvas c, RecyclerView parent) {
}
@Deprecated
public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {
outRect.set(0, 0, 0, 0);
}
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, State state) {
getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),
parent);
}
}
该抽象类主要由三个方法组成:
- onDraw(Canvas c, RecyclerView parent, State state):在Item绘制之前被调用(先于drawChildren),主要用于绘制分割线样式。
- onDrawOver(Canvas c, RecyclerView parent, State state):在Item绘制之后被调用(慢于drawChildren),主要用于绘制分割线样式。
- getItemOffsets(Rect outRect, View view, RecyclerView parent, State state):通过outRect.set()为每个Item设置一定的偏移量。
onDraw
和onDrawOver
这两个方法都是用于绘制分割线,我们在使用时只需要按需求选择一个进行实现就可以。它们的区别在于执行时间的不同,我们可以通过源码找到它们的区别。
RecyclerView源码:
public class RecyclerView extends ViewGroup implements ScrollingView, NestedScrollingChild2 {
@Override
public void draw(Canvas c) {
super.draw(c);
final int count = mItemDecorations.size();
for (int i = 0; i < count; i++) {
mItemDecorations.get(i).onDrawOver(c, this, mState);
}
@Override
public void onDraw(Canvas c) {
super.onDraw(c);
final int count = mItemDecorations.size();
for (int i = 0; i < count; i++) {
mItemDecorations.get(i).onDraw(c, this, mState);
}
}
}
View源码:
public class View implements Drawable.Callback, KeyEvent.Callback,
AccessibilityEventSource {
public void draw(Canvas canvas) {
// Step 3, draw the content
if (!dirtyOpaque) onDraw(canvas);
// Step 4, draw the children
dispatchDraw(canvas);
}
}
首先执行的是RecyclerView中重写的draw()
方法,然后会去执行super.draw()
,即View的draw()
方法。在View的draw()
方法中,会先去执行onDraw()
,再去执行dispatchDraw()
方法,由于RecyclerView重写了onDraw()
方法,所以是先执行了RecyclerView中的onDraw()
方法。因此,它们的执行顺序为:onDraw()
->dispatchDraw()
->onDrawOver()
。不理解的话可以参照上面的图多看两遍。
Google给我们提供了一个实现类:DividerItemDecoration
,我们可以参照它去实现自定义的Item Decoration。
DividerItemDecoration源码:
public class DividerItemDecoration extends RecyclerView.ItemDecoration {
public static final int HORIZONTAL = LinearLayout.HORIZONTAL;
public static final int VERTICAL = LinearLayout.VERTICAL;
private static final String TAG = "DividerItem";
private static final int[] ATTRS = new int[]{ android.R.attr.listDivider };
private Drawable mDivider;
private int mOrientation;
private final Rect mBounds = new Rect();
public DividerItemDecoration(Context context, int orientation) {
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
if (mDivider == null) {
Log.w(TAG, "@android:attr/listDivider was not set in the theme used for this "
+ "DividerItemDecoration. Please set that attribute all call setDrawable()");
}
a.recycle();
setOrientation(orientation);
}
public void setOrientation(int orientation) {
if (orientation != HORIZONTAL && orientation != VERTICAL) {
throw new IllegalArgumentException(
"Invalid orientation. It should be either HORIZONTAL or VERTICAL");
}
mOrientation = orientation;
}
public void setDrawable(@NonNull Drawable drawable) {
if (drawable == null) {
throw new IllegalArgumentException("Drawable cannot be null.");
}
mDivider = drawable;
}
@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
if (parent.getLayoutManager() == null || mDivider == null) {
return;
}
if (mOrientation == VERTICAL) {
drawVertical(c, parent);
} else {
drawHorizontal(c, parent);
}
}
private void drawVertical(Canvas canvas, RecyclerView parent) {
canvas.save();
final int left;
final int right;
//noinspection AndroidLintNewApi - NewApi lint fails to handle overrides.
if (parent.getClipToPadding()) {
left = parent.getPaddingLeft();
right = parent.getWidth() - parent.getPaddingRight();
canvas.clipRect(left, parent.getPaddingTop(), right,
parent.getHeight() - parent.getPaddingBottom());
} else {
left = 0;
right = parent.getWidth();
}
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
parent.getDecoratedBoundsWithMargins(child, mBounds);
final int bottom = mBounds.bottom + Math.round(child.getTranslationY());
final int top = bottom - mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(canvas);
}
canvas.restore();
}
private void drawHorizontal(Canvas canvas, RecyclerView parent) {
canvas.save();
final int top;
final int bottom;
//noinspection AndroidLintNewApi - NewApi lint fails to handle overrides.
if (parent.getClipToPadding()) {
top = parent.getPaddingTop();
bottom = parent.getHeight() - parent.getPaddingBottom();
canvas.clipRect(parent.getPaddingLeft(), top,
parent.getWidth() - parent.getPaddingRight(), bottom);
} else {
top = 0;
bottom = parent.getHeight();
}
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
parent.getLayoutManager().getDecoratedBoundsWithMargins(child, mBounds);
final int right = mBounds.right + Math.round(child.getTranslationX());
final int left = right - mDivider.getIntrinsicWidth();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(canvas);
}
canvas.restore();
}
@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent,
RecyclerView.State state) {
if (mDivider == null) {
outRect.set(0, 0, 0, 0);
return;
}
if (mOrientation == VERTICAL) {
outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
} else {
outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
}
}
}
从源码中可以看到该类是用系统中的android.R.attr.listDivider
来作为分割线,通过DividerItemDecoration构造方法中的setOrientation(orientation)
来设置分割线的方向。在getItemOffsets()
中利用outRect.set()
去设置了绘制的范围,再在onDraw()
中进行真正的绘制。
使用方法:
//设置分割线
mRecycleView.addItemDecoration(new DividerItemDecoration(this,
DividerItemDecoration.VERTICAL));
运行效果:
事件监听
RecyclerView并没有给我们提供现成的点击事件监听,需要我们自己去实现。我们可以在RecyclerView的Adapter中自定义一个接口,并创建一个供其他类设置监听的方法。
public class MyRecycleViewAdapter extends RecyclerView.Adapter<MyRecycleViewAdapter.MyHolder> {
private List mList;//数据源
private OnItemClickListener onItemClickListener;
/**
* 供外部调用设置监听
* @param onItemClickListener
*/
public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
this.onItemClickListener = onItemClickListener;
}
/**
* 自定义的接口
*/
public interface OnItemClickListener {
void onItemClick(View view, int position);
}
//通过方法提供的ViewHolder,将数据绑定到ViewHolder中
@Override
public void onBindViewHolder(final MyHolder holder, int position) {
holder.textView.setText(mList.get(position).toString());
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (onItemClickListener != null) {
onItemClickListener.onItemClick(v, holder.getAdapterPosition() + 1);
}
}
});
}
}
以上省略了部分与该内容无关的代码。当我们定义好接口后,我们在onBindViewHolder()
方法中为holder.itemView
(itemView是列表中的每一个item项)设置了点击事件监听,然后在onClick()
中判断是否有用户传递过onItemClickListener
实例进来,有的话会调用他的onItemClick()
,将点击事件转移到我们的自定义接口上,传给外面的调用者。调用者代码如下:
mAdapter.setOnItemClickListener(new MyRecycleViewAdapter.OnItemClickListener() {
@Override
public void onItemClick(View view, int position) {
Toast.makeText(getApplicationContext(), "第" + position + "条数据", Toast.LENGTH_SHORT).show();
}
});
到这里点击事件就完成了。如果你想实现长按也是同样的方法,在自定义的接口中多加一个长按的方法,然后holder.itemView
调用setOnLongClickListener()
去将长按事件转移到自定义的接口上。
ItemAnimator 动画
RecyclerView可以通过mRecyclerView.setItemAnimator(ItemAnimator animator)
来设置添加和移除时的动画效果。ItemAnimator
是一个抽象类,RecyclerView为我们提供了一个ItemAnimator
的实现类DefaultItemAnimator
。
使用方法:
//设置动画效果
mRecycleView.setItemAnimator(new DefaultItemAnimator());
在adapter中添加两个方法,用于添加和移除Item。这里要注意的是,更新数据集要用notifyItemInserted(position)
与notifyItemRemoved(position)
,而不是notifyDataSetChanged()
,否则没有动画效果。
/**
* 添加数据
*/
public void addItem() {
mList.add(0, "new ");
notifyItemInserted(0);
}
/**
* 移除数据
* @param position
*/
public void removeItem(int position) {
mList.remove(position);
notifyItemRemoved(position);
}
效果是按下底部“添加”按钮会在顶部插入数据,点击列表中的Item则删除该条数据。
如果我们对这种动画效果不满意,也可以去自定义各种动画效果。目前github上有许多开源的项目,例如RecyclerViewItemAnimators,我们可以直接去引用或学习它的动画效果。
结论:以上就是RecyclerView的基本用法,看到这里可能很多人会觉得它比ListView复杂得多,很多东西都需要自己去定义,但正是这种定制性使得它具有良好的扩展性,我们可以根据具体需求去自定义自己想要实现的效果,相信你也会喜欢上这个控件!
Android控件RecyclerView的基本用法的更多相关文章
- Android控件RecyclerView与ListView的异同
在我的一篇介绍Android新控件RecyclerView的博客(Android L新控件RecyclerView简介)中,一个读者留言说RecyclerView跟ListView之间好像没有什么不同 ...
- android控件RecyclerView中,如何显示自定义分割线以及最后一项去除分割线
在控件RecyclerView中,分割线DividerItemDecoration类的使用经常见,如果是使用自带的分割线,只需要这样写即可 RecyclerView mRecyclerView; mR ...
- 【Android】15.0 UI开发(六)——列表控件RecyclerView的网格布局排列实现
1.0 列表控件RecyclerView的网格布局排列实现,关键词GridLayoutManager. LinearLayoutManager 实现顺序布局 GridLayoutManager 实现网 ...
- 【Android】14.0 UI开发(五)——列表控件RecyclerView的瀑布布局排列实现
1.0 列表控件RecyclerView的瀑布布局排列实现,关键词StaggeredGridLayoutManager LinearLayoutManager 实现顺序布局 GridLayoutMan ...
- 【Android】16.0 UI开发(七)——列表控件RecyclerView的点击事件实现
1.0 在各布局的基础上,修改ProvinceAdapter.java的代码: package com.example.recyclerviewtest; import android.support ...
- 【Android - 控件】之MD - RecyclerView的使用
RecyclerView是Android 5.0新特性——Material Design中的一个控件,它将ListView.GridView整合到一起,可以使用极少的代码在ListView.GridV ...
- android控件的属性
android控件的属性 本节描述android空间的位置,内容等相关属性及属性的含义 第一类:属性值为true或false android:layout_centerHrizontal 水平居中 ( ...
- Android控件介绍
1. 介绍 Android控件大多位于android.widget, android.view.View为他们的父类对于Dialog系列, android.app.Dialog为父类 Android的 ...
- [Android Pro] android控件ListView顶部或者底部也显示分割线
reference to : http://blog.csdn.net/lovexieyuan520/article/details/50846569 在默认的Android控件ListView在 ...
随机推荐
- JLINK固件烧写
最近在使用uVision V5.14.0.0 的时候,由于我使用的Jlink是盗版的,导致软件总是退出,然后再网上找到了解决办法. 下面介绍解决办法: 参考: http://www.9mcu.com/ ...
- 【JavaWeb】通过邮件找回密码
前言 本文将介绍忘记密码时通过发送重置密码邮件找回密码的实现思路.整个实现过程中最重要的就是以下三点: 如何发送邮件到用户指定邮箱 邮件中的重置密码链接构成是怎么样的 验证重置密码链接的合法性(是否过 ...
- 微信中浏览器支持input调用摄像头和只能上传图片
<input type="file" capture="camera" accept="image/*" />
- WebMvcConfig
package cn.xx.yy; import java.util.ArrayList;import java.util.HashMap;import java.util.List;import j ...
- jade过滤器
以上语法基本讲完了jade的语法,然后在jade里面并不仅仅局限于使用jade语法,同样可以使用其他的插件语言,这种机制在jade里面称为filter,在jade里面加入过滤器用冒号 markdown ...
- flink相关
flink一.简单实时计算方案 假如现在我们有一个电商平台,每天访问的流量巨大,主要访问流量都集中在衣服类.家电类页面,那么我们想实时看到这两类页面的访问量走势(十分钟出一个统计量),当做平台的重要指 ...
- linux bash环境变量简单总结
来源链接:http://www.178linux.com/8005 原创文章,如有转载,请注明原文地址 一.环境变量简介 Linux是一个多用户的操作系统.每个用户登录系统后,都会有一个专用的运行环境 ...
- 25-SQLServer中的DMV和DMF的使用
一.总结 1.什么事DMV和DMFDMV(Dynamic Management View):动态管理视图DMF(Dynamic Management Function):动态管理函数 二.操作步骤 1 ...
- python函数入参和返回值
以下内容参考自runoob网站,以总结python函数知识点,巩固基础知识,特此鸣谢! 原文地址:http://www.runoob.com/python3/python3-function.html ...
- 2018HDU多校联赛第六场 6373 Pinball——水题&&物理题
题意 给定一个斜面,从某处让一个小球作自由落体运动,求小球与斜面的碰撞次数(假设都为弹性碰撞). 分析 题图如下,x轴.y轴是虚拟的. 根据高中物理的套路,沿斜面方向分解重力加速度即可. #inclu ...