RecyclerView详细解释
-
- RecyclerView简单介绍
- RecyclerView简单使用
- 核心类的介绍
- ViewHolder
- Adapter
- 开始使用
- 核心类的介绍
- 布局管理LayoutManager
- 常用API
- 设置一个瀑布流式的布局
- 分隔条RecyclerViewItemDecoration
- 具体使用
- 自定义分割符
- 最简单的分割符
- 网格布局中的分隔符实例
- 动画RecyclerViewItemAnimator
- 事件监听listener
RecyclerView简单介绍
RecyclerView是一个高度的解耦，异常的灵活的View，通过设置它提供的不同LayoutManager，ItemDecoration , ItemAnimator实现令人瞠目的效果。
RecyclerView与老前辈ListView的不同点，主要在于以下几个特性：
Adapter中的ViewHolder模式 对于ListView来说，通过创建 ViewHolder 来提升性能并不是必须的。因为ListView并没有严格的ViewHolder设计模式。但是在使用RecyclerView的时候，Adapter 必须实现至少一个ViewHolder，必须遵循ViewHolder设计模式。
定制Item条目 ListView只能实现垂直线性排列的列表视图，与之不同的是，RecyclerView可以通过设置RecyclerView.LayoutManager来定制不同风格的视图，比如水平滚动列表或者不规则的瀑布流列表。
tem动画 在ListView中没有提供任何方法或者接口，方便开发者实现Item的增删动画。相反地，可以通过设置RecyclerView的 RecyclerView.ItemAnimator 来为条目增加动画效果。
设置数据源 在LisView中针对不同数据封装了各种类型的 Adapter ，比如用来处理数组的 ArrayAdapter 和用来展示Database结果的 CursorAdapter 。相反地，在RecyclerView中必须自定义实现 RecyclerView.Adapter 并为其提供数据集合。
设置条目分割线 在ListView中可以通过设置 android:divider 属性来为两个Item间设置分割线。如果想为RecyclerView添加此效果，则必须使用 RecyclerView.ItemDecoration ，这种实现方式不仅更灵活，而且样式也更加丰富。
设置点击事件 在ListView中存在 AdapterView.OnItemClickListener 接口，用来绑定条目的点击事件。但是，很遗憾的是在RecyclerView中，并没有提供这样的接口，不过，提供了另外一个接口 RcyclerView.OnItemTouchListener ，用来响应条目的触摸事件。
RecyclerView简单使用
一个是在Gradle中直接添加：
compile 'com.android.support:recyclerview-v7:24.2.1'版本号不用找，仿照上面的appcompat直接用，把appcompat改成recyclerview即可
compile 'com.android.support:appcompat-v7:24.2.1'第二种是在Design面板直接拖拽，会提示你添加
核心类的介绍
RecyclerView的任务仅限于回收和定位屏幕上的View。 View能够显示数据还离不
开另外两个类的支持：Adapter子类和ViewHolder子类。
RecyclerView.Adapter 处理数据集合并负责绑定视图
ViewHolder 持有所有的用于绑定数据或者需要操作的View
LayoutManager 负责摆放视图等相关操作
ItemDecoration 负责绘制Item附近的分割线
ItemAnimator 为Item的一般操作添加动画效果，如，增删条目等
ViewHolder
ViewHolder只做一件事：容纳View视图
RecyclerView自身不会创建视图，它创建的是ViewHolder，而ViewHolder引用着一个个
itemView，如下图：
可以通过打印 ViewHolder.toString 来获取更多有效信息
@Override
public String toString() {
final StringBuilder sb = new StringBuilder("ViewHolder{" +
Integer.toHexString(hashCode()) + " position=" + mPosition + " id=" + mItemId +
", oldPos=" + mOldPosition + ", pLpos:" + mPreLayoutPosition);
if (isScrap()) {
sb.append(" scrap ")
.append(mInChangeScrap ? "[changeScrap]" : "[attachedScrap]");
}
if (isInvalid()) sb.append(" invalid");
if (!isBound()) sb.append(" unbound");
if (needsUpdate()) sb.append(" update");
if (isRemoved()) sb.append(" removed");
if (shouldIgnore()) sb.append(" ignored");
if (isTmpDetached()) sb.append(" tmpDetached");
if (!isRecyclable()) sb.append(" not recyclable(" + mIsRecyclableCount + ")");
if (isAdapterPositionUnknown()) sb.append(" undefined adapter position");
if (itemView.getParent() == null) sb.append(" no parent");
sb.append("}");
return sb.toString();
}Adapter
Adapter是个控制器对象，从模型层获取数据，然后提供给RecyclerView显示，起到了沟通的桥梁作用，adapter负责：
1、创建必要的ViewHolder；
2、 绑定ViewHolder至模型层数据。
public VH onCreateViewHolder(ViewGroup parent, int viewType) 创建Item视图，并返回相应的ViewHolder
public void onBindViewHolder(VH holder, int position) 绑定数据到正确的Item视图上。
public int getItemCount() 返回该Adapter所持有的Itme数量
要创建adapter， 首先要定义RecyclerView.Adapter子类，RecyclerView需要显示视图对象时， 就会去找它的adapter，如下图：
首先，通过调用adapter的getItemCount()方法，RecyclerView询问数组列表中包含多少个
对象。
接 着 ， RecyclerView 调 用 adapter 的 createViewHolder(ViewGroup, int) 方 法 创 建
ViewHolder以及ViewHolder要显示的视图。
最后， RecyclerView会传入ViewHolder及其位置， 调用onBindViewHolder(ViewHolder,
int)方法。adapter会找到目标位置的数据并绑定到ViewHolder的视图上。所谓绑定，就是使用
模型数据填充视图。
整个过程执行完毕，RecyclerView就能在屏幕上显示crime列表项了。需要注意的是，相对
于onBindViewHolder(ViewHolder, int)方法，createViewHolder(ViewGroup, int)方法
的调用并不频繁。一旦创建了够用的ViewHolder，RecyclerView就会停止调用createView
Holder(…)方法。然后，通过回收利用旧的ViewHolder节约时间和内存。
开始使用
首先创建一个JavaBean负责模拟数据
public class JavaBean {
String name;
int age;
public JavaBean(String name, int age) {
this.name = name;
this.age = age;
}
}然后在根据上面的两种方式添加依赖，之后设置控制器：
/**
* @author HaoTianYi [email protected]
* @version v1.0
* @des 一个作用是初始化UI、一个是负责更新数据
* @time 2016-11-10 18:54
*/
public class MyHolder extends RecyclerView.ViewHolder {
private TextView mTvAge;
private TextView mTvName;
public MyHolder(View itemView) {
super(itemView);
// 初始化View
mTvAge = (TextView) itemView.findViewById(R.id.age);
mTvName = (TextView) itemView.findViewById(R.id.name);
}
/**
* 负责更新数据也就是刷新UI
* @param bean 数据
* @call 由MyAdapter的onBindViewHolder方法调用
*/
public void bindData(JavaBean bean) {
mTvAge.setText(" "+bean.age);
mTvName.setText(bean.name);
}
}设置内容填充者：
/**
* @author HaoTianYi [email protected]
* @version v1.0
* @des 从模型层拿到数据并且传递给RecyclerView（中间人的角色）
* @time 2016-11-10 18:54
*/
public class MyAdapter extends RecyclerView.Adapter<MyHolder> {
private List mBeen;
public MyAdapter(List been) {
mBeen = been;
}
@Override
public MyHolder onCreateViewHolder(ViewGroup parent, int viewType) {
// 可以从parent得到context，没有必要在传递一个context参数
// 这里的父布局参数是null
View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, null);
return new MyHolder(itemView);
}
/**
* 一旦创建填充满屏幕的item之后，在滑动item就会复用
* 也就是不再调用onCreateViewHolder而是调用onBindViewHolder
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(MyHolder holder, int position) {
// 用控制器控制数据
holder.bindData(mBeen.get(position));
}
@Override
public int getItemCount() {
return mBeen.size();
}
} Activity的使用代码：
public class MainActivity extends AppCompatActivity {
private List mBeen = new ArrayList();
private final String NAME = "普朗特";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
init();
}
private void init() {
// 模拟数据
for (int i = 0; i < 50; i++) {
JavaBean javaBean = new JavaBean(NAME + i, i);
mBeen.add(javaBean);
}
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rv);
recyclerView.setAdapter(new MyAdapter(mBeen));
// 一定要设置布局，否则不会显示内容
recyclerView.setLayoutManager(new LinearLayoutManager(MainActivity.this));
}
} 相比ListView而言，RecyclerView的每一个类都是真是职责超级单一啊！！！
最后放上item的代码：
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="60dp"
android:orientation="horizontal">
<TextView
android:id="@+id/name"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1"
android:gravity="center"
android:text="nihao"
android:textSize="20sp"/>
<TextView
android:id="@+id/age"
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1"
android:gravity="center"
android:text="llll"
android:textSize="20sp"/>
LinearLayout>布局管理LayoutManager
布局管理的基类是RecyclerView.LayoutManager（抽象类）
LinearLayoutManager 线性管理器，支持横向、纵向。
GridLayoutManager 网格布局管理器
StaggeredGridLayoutManager 瀑布式布局管理器
改变上面的代码，瞬间实现水平滚动：
LinearLayoutManager manager = new LinearLayoutManager(MainActivity.this);
manager.setOrientation(LinearLayoutManager.HORIZONTAL);
recyclerView.setLayoutManager(manager);实现网格管理器，每一行4列
recyclerView.setLayoutManager(new GridLayoutManager(MainActivity.this,4));瀑布流管理器，当第二个参数设置成Vertical时和上面一样：
recyclerView.setLayoutManager(new StaggeredGridLayoutManager(4,StaggeredGridLayoutManager.VERTICAL));当设置成HORIZONTAL变成水平是4行，这时是水平滑动的，item的宽度需要注意去设置，毕竟横向的宽度没有约束了，应为控件可以横向滚动了。，这里没有严重的变形是因为字体设置了大小
常用API
findFirstVisibleItemPosition() 返回当前第一个可见Item的position
findFirstCompletelyVisibleItemPosition() 返回当前第一个完全可见Item的position
findLastVisibleItemPosition() 返回当前最后一个可见Item的position
findLastCompletelyVisibleItemPosition() 返回当前最后一个完全可见Item的position
设置一个瀑布流式的布局
要把每个item的高度不固定，即可实现,首先改Adapter中的onCreateViewHolder方法
@Override
public MyHolder onCreateViewHolder(ViewGroup parent, int viewType) {
// 可以从parent得到context，没有必要在传递一个context参数
// 这里的父布局参数是null
View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, null);
//设置随机高度
int height = (int) (Math.random() * 100);
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(954/4,300+height);
params.setMargins(10,10,10,10);
itemView.setLayoutParams(params);
return new MyHolder(itemView);
}Activity中的引用代码不变：
StaggeredGridLayoutManager manager = new StaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL);
recyclerView.setLayoutManager(manager);这时可以实现，但是每一个item在一会就会改变，而且有动画效果
可以看到在滑动时候会有布局的变化，重写Adapter中的getItemViewType可以使每一个item固定
@Override
public int getItemViewType(int position) {
return position;
}现在是没有布局变化了
分隔条RecyclerView.ItemDecoration
通过设置 recyclerView.addItemDecoration(new DividerDecoration(this)); 来改变Item之间的偏移量或者对Item进行装饰。
RecyclerView.ItemDecoration 是一个抽象类，可以通过重写以下三个方法，来实现Item之间的偏移量或者装饰效果：
public void onDraw(Canvas c, RecyclerView parent) 装饰的绘制在Item条目绘制之前调用，所以这有可能被Item的内容所
遮挡
public void onDrawOver(Canvas c, RecyclerView parent) 装饰的绘制在Item条目绘制之后调用，因此装饰将浮于Item之上
public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) 与 padding 或 margin 类 似 ，LayoutManager在测量阶段会调用该方法，计算出每一个Item的正确尺寸并设置偏移量。
具体使用
public class DividerItemDecoration extends RecyclerView.ItemDecoration {
/**
* 设置一个属性集合，可以在自己的attrs中自行设置
*/
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;
/**
* 分割符的Drawable
*/
private Drawable mDivider;
private int mOrientation;
public DividerItemDecoration(Context context, int orientation) {
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
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) {
System.out.println("recyclerview - itemdecoration onDraw()");
if (mOrientation == VERTICAL_LIST) {
drawVertical(c, parent);
} else {
drawHorizontal(c, parent);
}
}
/**
* 绘制垂直分割符（如果是垂直滑动的话）
* @param c
* @param parent
*/
public void drawVertical(Canvas c, RecyclerView parent) {
final int left = parent.getPaddingLeft();
final int right = parent.getWidth() - parent.getPaddingRight();
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
android.support.v7.widget.RecyclerView v = new android.support.v7.widget.RecyclerView(parent.getContext());
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
// 找出每一个分割符的距离，就是分隔符上下左右四个点的坐标
final int top = child.getBottom() + params.bottomMargin;
final int bottom = top + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}
/**
* 绘制水平分割符（如果是水平滑动的话）
* @param c
* @param parent
*/
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);
}
}
}在上面的代码中更改Activity中的代码：
recyclerView.addItemDecoration(new DividerItemDecoration(MainActivity.this,DividerItemDecoration.VERTICAL_LIST));自定义分割符
只要在attrs中添加一个android:listDivider属性即可,其余全部是自动生成的：
-- Base application theme. -->
对应的自定义divider_item.xml
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<size android:width="3dp" android:height="3dp"/>
<solid android:color="@color/colorPrimaryDark"/>
shape>最简单的分割符
如果只是想设置一个空余的间距，在Adapter中设置margin跟少的代码量，改变adapter中的onCreateViewHolder方法：
@Override
public MyHolder onCreateViewHolder(ViewGroup parent, int viewType) {
// 可以从parent得到context，没有必要在传递一个context参数
// 这里的父布局参数是null
View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, null);
LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(parent.getWidth(),150);
params.setMargins(10,10,10,10);
itemView.setLayoutParams(params);
return new MyHolder(itemView);
}网格布局中的分隔符实例
参考：csdn
public class DividerGridItemDecoration extends RecyclerView.ItemDecoration
{
private static final int[] ATTRS = new int[] { android.R.attr.listDivider };
private Drawable mDivider;
public DividerGridItemDecoration(Context context)
{
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
a.recycle();
}
@Override
public void onDraw(Canvas c, RecyclerView parent)
{
drawHorizontal(c, parent);
drawVertical(c, parent);
}
private int getSpanCount(RecyclerView parent)
{
// 列数
int spanCount = -1;
RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{
spanCount = ((GridLayoutManager) layoutManager).getSpanCount();
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
spanCount = ((StaggeredGridLayoutManager) layoutManager)
.getSpanCount();
}
return spanCount;
}
public void drawHorizontal(Canvas c, RecyclerView parent)
{
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.getLeft() - params.leftMargin;
final int right = child.getRight() + params.rightMargin
+ mDivider.getIntrinsicWidth();
final int top = child.getBottom() + params.bottomMargin;
final int bottom = top + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}
public void drawVertical(Canvas c, RecyclerView parent)
{
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 top = child.getTop() - params.topMargin;
final int bottom = child.getBottom() + params.bottomMargin;
final int left = child.getRight() + params.rightMargin;
final int right = left + mDivider.getIntrinsicWidth();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}
private boolean isLastColum(RecyclerView parent, int pos, int spanCount,
int childCount)
{
RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{
if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
{
return true;
}
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
int orientation = ((StaggeredGridLayoutManager) layoutManager)
.getOrientation();
if (orientation == StaggeredGridLayoutManager.VERTICAL)
{
if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
{
return true;
}
} else
{
childCount = childCount - childCount % spanCount;
if (pos >= childCount)// 如果是最后一列，则不需要绘制右边
return true;
}
}
return false;
}
private boolean isLastRaw(RecyclerView parent, int pos, int spanCount,
int childCount)
{
RecyclerView.LayoutManager layoutManager = parent.getLayoutManager();
if (layoutManager instanceof GridLayoutManager)
{
childCount = childCount - childCount % spanCount;
if (pos >= childCount)// 如果是最后一行，则不需要绘制底部
return true;
} else if (layoutManager instanceof StaggeredGridLayoutManager)
{
int orientation = ((StaggeredGridLayoutManager) layoutManager)
.getOrientation();
// StaggeredGridLayoutManager 且纵向滚动
if (orientation == StaggeredGridLayoutManager.VERTICAL)
{
childCount = childCount - childCount % spanCount;
// 如果是最后一行，则不需要绘制底部
if (pos >= childCount)
return true;
} else
// StaggeredGridLayoutManager 且横向滚动
{
// 如果是最后一行，则不需要绘制底部
if ((pos + 1) % spanCount == 0)
{
return true;
}
}
}
return false;
}
@Override
public void getItemOffsets(Rect outRect, int itemPosition,
RecyclerView parent)
{
int spanCount = getSpanCount(parent);
int childCount = parent.getAdapter().getItemCount();
if (isLastRaw(parent, itemPosition, spanCount, childCount))// 如果是最后一行，则不需要绘制底部
{
outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
} else if (isLastColum(parent, itemPosition, spanCount, childCount))// 如果是最后一列，则不需要绘制右边
{
outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
} else
{
outRect.set(0, 0, mDivider.getIntrinsicWidth(),
mDivider.getIntrinsicHeight());
}
}动画RecyclerView.ItemAnimator
在Android中默认实现了一个 DefaultItemAnimator
ItemAnimator能够帮助Item实现独立的动画，ItemAnimator作触发于以下三种事件：
- 某条数据被插入到数据集合中
- 从数据集合中移除某条数据
- 更改数据集合中的某条数据
事件监听listener
public void setOnItemClickListener(@Nullable OnItemClickListener listener) Item点击事件监听
public void setOnItemLongClickListener(OnItemLongClickListener listener) Item长按事件监听
首先在Adapter中设置一个回调接口，添加OnItemClickListener接口，更改onBindViewHolder方法
private OnItemClickListener mOnItemClickListener;
interface OnItemClickListener {
// 点击事件
void onItemClick(View view, int position);
// 长按事件
void onItemLongClick(View view, int position);
}
public void setOnItemClickLitener(OnItemClickListener mLitener) {
mOnItemClickListener = mLitener;
}
/**
* 一旦创建填充满屏幕的item之后，在滑动item就会复用
* 也就是不再调用onCreateViewHolder而是调用onBindViewHolder
*
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(final MyHolder holder, final int position) {
// 用控制器控制数据
System.out.println(holder.toString());
holder.bindData(mBeen.get(position));
if (mOnItemClickListener != null) {
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
mOnItemClickListener.onItemClick(holder.itemView, position);
}
});
holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
@Override
public boolean onLongClick(View v) {
mOnItemClickListener.onItemLongClick(holder.itemView, position);
return true;
}
});
}
}在Activity中设置监听：
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rv);
mAdapter = new MyAdapter(mBeen);
mAdapter.setOnItemClickLitener(new MyAdapter.OnItemClickListener() {
@Override
public void onItemClick(View view, int position) {
System.out.println("-----"+"onItemClick"+"-----");
}
@Override
public void onItemLongClick(View view, int position) {
System.out.println("-----"+"onItemLongClick"+"-----");
}
});
recyclerView.setAdapter(mAdapter);触发事件，可以看到结果：
参考RecyclerView
作者官方博客天意博文
原文地址RecyclerView详细解释