Android RecyclerView基本使用
一、概述
1、RecyclerView继承关系:
java.lang.Object ↳ android.view.View ↳ android.view.ViewGroup ↳ android.support.v7.widget.RecyclerView
可以看出此控件直接继承ViewGroup,与AdapterView平级,并不像ListView,GridView,Spinner那样继承与AdapterView;
2、RecyclerView特点:
与常用的ListView,GridView,Spinner不一样的地方在于RecyclerView的高度解耦,内部只负责处理回收和复用Item,其余的所有事情均交于外部实现,可定制性强,通过此控件可以轻松实现ListView,GridView,瀑布流展示的效果;
二、基本用法
1、导入支持包(AndroidStudio在项目对应Module的build.gradle中配置):
dependencies { compile 'com.android.support:recyclerview-v7:23.3.0' }
2、在对应的布局xml中使用:
<?xml version="1.0" encoding="utf-8"?><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" android:paddingBottom="@dimen/activity_vertical_margin" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" tools:context="com.zhulei.recyclerview_test.MainActivity"> <android.support.v7.widget.RecyclerView android:id="@+id/recycler" android:layout_width="match_parent" android:layout_height="match_parent"> </android.support.v7.widget.RecyclerView></RelativeLayout>
3、设置布局管理器(必要):
官方给出了三种布局管理器,都是继承于RecyclerView.LayoutManager:
java.lang.Object ↳ android.support.v7.widget.RecyclerView.LayoutManagerKnown Direct SubclassesLinearLayoutManager, StaggeredGridLayoutManagerKnown Indirect SubclassesGridLayoutManager
设置接口很简单(根据需求下面三选一):
(1)LinearLayoutManager,实现效果和Listview完全一致:
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
(2)GridLayoutManager,可以实现GridView的效果:
mRecyclerView.setLayoutManager(new GridLayoutManager(this, 4, LinearLayoutManager.VERTICAL, false));
这里构造方法中给了四个参数:第一个是上下文,第二个是指定行数(列数),第三个是指定水平排列还是垂直排列,第四个参数设置从底部往顶部排列(true)还是顶部往底部排列(false),当然也提供了两个参数的构造方法,请自行查看,设置了相关默认值;
(3)StaggeredGridLayoutManager,瀑布流式布局管理器:
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(6, StaggeredGridLayoutManager.VERTICAL));
这里构造方法中参数很好理解分别是行数(列数)和排列方向,实现效果如下图:
a、设置垂直排列布局,在Adapter的onBindViewHolder回调中设置每个Item的高度模拟瀑布流UI效果:
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));
注意点:我设置两列时候,数据排列顺序是水平从左到右放置的,垂直方向上可以实现滚动;
b、设置水平排列布局:
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(8, StaggeredGridLayoutManager.HORIZONTAL));
注意点:我设置的是8行,数据排列顺序是从上到下展示,水平方向上可以实现滚动;
4、设置适配器(必要),可以同时实现Item点击监听(由于RecyclerView没有提供设置点击监听的接口,这里只能自己实现):
mAdapter = new MyAdapter(this, mListData);mAdapter.setOnItemClickedListener(new View.OnClickListener() { @Override public void onClick(View v) { Toast.makeText(MainActivity.this, "click", Toast.LENGTH_SHORT).show(); } });mRecyclerView.setAdapter(mAdapter);
MyAdapter代码如下(这里我是写在Activity里的内部类,用了静态的):
public static class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder>{ private Context mContext; private ArrayList<String> mDataList; private View.OnClickListener mItemClickedListener; public MyAdapter(Context context, ArrayList<String> data){ this.mContext = context; this.mDataList = data; } public void setOnItemClickedListener(View.OnClickListener listener){ this.mItemClickedListener = listener; } @Override public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { MyViewHolder vh = new MyViewHolder(LayoutInflater.from(mContext).inflate(R.layout.item_recycler, parent, false)); return vh; } @Override public void onBindViewHolder(MyViewHolder holder, int position) { holder.mTextContent.setText(mDataList.get(position)); holder.mTextContent.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { if (mItemClickedListener != null){ mItemClickedListener.onClick(v); } } }); } @Override public int getItemCount() { return mDataList.size(); } class MyViewHolder extends RecyclerView.ViewHolder{ @BindView(R.id.tv_content) TextView mTextContent; public MyViewHolder(View itemView) { super(itemView); ButterKnife.bind(this, itemView); } } }
可以看出RecyclerView的适配器中需要一个Viewholder,这个Viewholder需要继承RecyclerView.ViewHolder;
5、设置Item的移除和增加动画(非必要):
mRecyclerView.setItemAnimator(new DefaultItemAnimator());
这里使用的是系统提供的一个默认动画,效果如下图(同时可以看到上面设置的点击事件监听):
注意点:这里演示了三个事件,分别是添加,移除,点击事件;
添加事件:和ListView一样需要改变在数据源的相应位置添加对应数据,然后notify,但是这里要用上动画,需要使用RecyclerView.Adapter中的这个接口:
notifyItemInserted(position);
移除事件:同添加一样,改变数据源之后,调用RecyclerView.Adapter中的这个接口:
notifyItemRemoved(position);
6、设置分隔线(非必要):
mRecyclerView.addItemDecoration(RecyclerView.ItemDecoration);
这里设置分割线的方式需要写一个继承于RecyclerView.ItemDecoration的实体类,然后去画分割线,有些繁琐,如果只是简单的分割线,直接在Item的xml布局中设置Margin或者画出一个自己想要的View即可。
三、总结:
可以看出RecyclerView除了可以实现ListView,GridView效果外还可以轻松实现瀑布流的UI展示界面,只不过RecyclerView的高度解耦,内部只做了recycle的事情,交由外部定制的东西有些多,需要我们实现:
1、设置布局管理器(必须);
2、设置适配器(必须);
3、设置点击事件(如需);
4、设置Item的移除和增加动画(如需);
5、设置分隔线(如需);
更多相关文章
- android 对话框模板布局之一
- android 写布局的时候注意大小写
- android xml 布局错误
- android拍照上传的效果是如何实现的
- Android shape实现渐变、部分圆角及叠加效果
- Android开发窗口实现半透明效果
- Android学习笔记(二)android studio基本控件及布局(实现图片查看器)
- 为什么 Android 中 Toolbar.setTitle() 没有效果
- iphone4抖动效果源码