- 本文是转存自 陈育的揭开RecyclerView的神秘面纱(一):RecyclerView的基本使用,附传送门 。
- 本文只为自己做个记录,方便以后查找。如若侵权,请告知,将第一时间删除。
以下为正文
前言
在Android开发中,我们经常与ListView、GridView打交道,它们为数据提供了列表和视图的展示方式,方便用户的操作。然而,随着Android的不断发展,单一的listview逐渐满足不了需求多变的项目了,因此,谷歌在support v7中,加入了新的控件——RecyclerView,该控件整合了ListView、GridView的特点,而且最大的优点是可以很方便实现瀑布流效果,因此RecyclerView受到越来越多的开发者重视。所以,学习RecyclerView的使用也是很有必要的。
引入RecyclerView
由于该控件并不在Andorid SDK中的,而是在support v7包中,因此我们要手动添加该控件。在build.gradle中添加如下依赖:
dependencies {
...
compile 'com.android.support:appcompat-v7:23.1.1' //Toolbar
compile 'com.android.support:recyclerview-v7:23.1.1' //RecyclerView
}
几个重要的类
在我们开始讲解RecyclerView的用法之前,我们要先认识几个它常用的内部类,因为这几个内部类很重要,贯穿整个使用过程:
1、RecyclerView.Adapter:抽象类,为RecyclerView提供数据,一般根据不同的业务需求来编写具体的实现类。
2、RecyclerView.LayoutManager:抽象类,主要用于测量RecyclerView的子Item,以及根据不同的布局方式来实现Item的布局效果,v 7包自带的实现类有:LinearLayoutManager、StaggeredGridLayoutManager、GridLayoutManager。
3、RecyclerView.ItemDecoration:抽象类,这个主要用于不同的Item之间添加分割线(可选)。官方没有实现类,所以如果要添加分割线,我们需要手动实现这个抽象类。
4、RecyclerView.ItemAnimator:抽象类,这个主要用于当一个item添加或者删除的时候出现的动画效果,官方提供一个默认的实现类。如果想要使我们的RecyclerView在添加、删除数据的时候有炫酷的动画,可以实现这个抽象类。
可以看到,这些重要的类都是抽象类,这就为RecyclerView的高度可定制性打下了坚实的基础,利用不同的实现类,能自由、灵活地使用RecyclerView,这也是RecyclerView的迷人之处。
RecyclerView的基本使用
接下来,将介绍RecyclerView的基本使用方法
使用线性布局
1、布局
在main.xml文件中进行如下布局:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:toolbar="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<android.support.v7.widget.Toolbar android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="?attr/colorPrimary"
toolbar:titleTextColor="@android:color/white"
toolbar:subtitleTextColor="@android:color/white"
toolbar:popupTheme="@style/ToolbarPopupTheme">
</android.support.v7.widget.Toolbar>
<android.support.v7.widget.RecyclerView
android:id="@+id/recyclerview"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>
这里使用了两个控件,一个是RecyclerView,一个是Toolbar,关于Toolbar的使用可以参考Android ToolBar 使用完全解析,基本上Toolbar相关代码都引用自这篇文章。这里不再赘述。
用过ListView的都应该了解,在创建了RecyclerView控件后,接着我们要创建item的布局,itemlayout.xml代码如下:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@android:color/holo_blue_light"
android:layout_margin="5dp">
<TextView
android:id="@+id/num"
android:layout_width="match_parent"
android:layout_height="50dp"
android:gravity="center"
android:textSize="20sp"/>
</LinearLayout>
这个Item布局很简单,里面只有一个textview,并且布局的背景颜色为蓝色,设置了margin值,为了与别的item相互区分出来。
2、创建Adapter适配器
与ListView类似地,RecyclerView也需要适配器来提供数据。上面说到RecyclerView提供了一个抽象类:RecyclerView.Adapter,我们通过继承该类来写自己的适配器。我们先看看这个抽象类里面的抽象方法:
public static abstract class Adapter<VH extends ViewHolder> {
public abstract VH onCreateViewHolder(ViewGroup parent, int viewType); // 1
public abstract void onBindViewHolder(VH holder, int position); // 2
public abstract int getItemCount(); // 3
}
继承该类的时候,必须重写这三个方法,我们分别解释一下这三个方法是什么作用:
①onCreateViewHolder
:创建ViewHolder,该方法会在RecyclerView需要展示一个item的时候回调。重写该方法时,应该使ViewHolder加载item view的布局。这个能发避免了不必要的findViewById操作,提高了性能。如果熟悉ListView的ViewHolder操作那么也能很容易理解这个。
②onBindeViewHolder
:该方法在RecyclerView在特定位置展示数据时候回调,顾名思义,把数据绑定、填充到相应的item view中。
③getItemCount
:返回数据的数量。我们注意到,继承该类的时候需要声明它的泛型类型VH,VH继承自RecyclerView.ViewHolder,同时第①个方法的返回值也是VH,由于ViewHolder是根据业务需求而变化的,不同的业务需求而需要的ViewHolder不尽相同,所以没必要单独写一个ViewHolder.java文件,因此我们可以在Adapter子类内部实现一个内部类ViewHolder,这样也符合单一职责原则。具体的Adapter适配器代码如下所示,
MyAdapter.java:
public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
private List<String> mDataSet; //构造器,接受数据集
public MyAdapter(List<String> data){
mDataSet = data;
}
@Override
public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
//加载布局文件
View v = LayoutInflater.from(parent.getContext()).inflate(R.layout.itemlayout,parent,false);
ViewHolder vh = new ViewHolder(v);
return vh;
}
@Override
public void onBindViewHolder(final ViewHolder holder, int position) {
//将数据填充到具体的view中
holder.mTextView.setText(mDataSet.get(position));
}
@Override
public int getItemCount() {
return mDataSet.size();
}
class ViewHolder extends RecyclerView.ViewHolder{
public TextView mTextView;
public ViewHolder(View itemView) {
super(itemView);
//由于itemView是item的布局文件,我们需要的是里面的textView,因此利用itemView.findViewById获
//取里面的textView实例,后面通过onBindViewHolder方法能直接填充数据到每一个textView了
mTextView = (TextView) itemView.findViewById(R.id.num);
}
}
}
3、MainActivity
一般在java代码中引用RecyclerView,要做如下工作:
①获取RecyclerView实例,通过findViewById()方法。
②为RecyclerView设置布局管理器
③为RecyclerView设置数据适配器Adapter。
我们来看看具体代码:
public class MainActivity extends AppCompatActivity {
private Toolbar toolbar;
private RecyclerView mRecyclerView;
private RecyclerView.LayoutManager mLayoutManager;
private MyAdapter mAdapter;
private List<String> mData;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initToolbar();
initData();
initRecyclerView();
}
private void initData() {
mData = new ArrayList<>();
for(int i=0;i<20;i++){
mData.add("Item "+i);
}
}
private void initRecyclerView() {
//1 实例化
RecyclerView mRecyclerView = (RecyclerView) findViewById(R.id.recyclerview);
mLayoutManager = new LinearLayoutManager(this);
//2 为RecyclerView创建布局管理器,这里使用的是LinearLayoutManager,表示里面的Item排列是线性排列
mRecyclerView.setLayoutManager(mLayoutManager);
mAdapter = new MyAdapter(mData);
//3 设置数据适配器
mRecyclerView.setAdapter(mAdapter);
}
private void initToolbar() {
toolbar = (Toolbar) findViewById(R.id.toolbar);
toolbar.setTitle("RecyclerView");
toolbar.setSubtitle("demo");
//设置导航图标、添加菜单点击事件要在setSupportActionBar方法之后
setSupportActionBar(toolbar);
toolbar.setNavigationIcon(R.mipmap.ic_drawer_home);
toolbar.setOnMenuItemClickListener(new Toolbar.OnMenuItemClickListener() {
@Override
public boolean onMenuItemClick(MenuItem item) {
switch (item.getItemId()) {
case R.id.action_search:
Toast.makeText(MainActivity.this, "Search !", Toast.LENGTH_LONG).show();
break;
case R.id.action_notifications:
Toast.makeText(MainActivity.this, "Notificationa !", Toast.LENGTH_SHORT).show();
break;
case R.id.action_settings:
Toast.makeText(MainActivity.this, "Settings !", Toast.LENGTH_SHORT).show();
break;
}
return true;
}
});
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_main, menu); return true;
}
}
经过以上的步骤后,我们运行程序:
可以看到,展示的效果正是我们设置的。不过为了达到这样的效果我们还是做了不少工作,甚至比ListView复杂了不少,但别心急,RecyclerView的优点我们还没看到,接下来将讲述它的多变的用法。
更改布局管理器
以上使用了LinearLayoutManager,线性布局管理器,使得item呈竖直排列或者水平排列,除了这种线性布局之外,官方还提供了另外两种布局方式,分别是GridLayoutManager和StaggeredGridLayoutManager。前者容易理解,是表格形式的布局,类似于GridView,而后者则是瀑布流表格布局。
1、GridLayoutManager要改变布局管理器很简单,我们只需要实例化一个表格布局管理器即可,我们先看看它的构造函数:
/**
* @param context Current context, will be used to access resources.
* @param spanCount The number of columns or rows in the grid
* @param orientation Layout orientation. Should be {@link #HORIZONTAL} or {@link
* #VERTICAL}.
* @param reverseLayout When set to true, layouts from end to start.
*/
public GridLayoutManager(Context context, int spanCount, int orientation,
boolean reverseLayout) {
super(context, orientation, reverseLayout);
setSpanCount(spanCount);
}
其中第二个参数spanCount表示表格的行数或者列数;第三个参数表示是水平滑动或者是竖直方向滑动;最后一个参数表示是否从数据的尾部开始显示。我们在MainActivity中作出如下修改:
mRecyclerView.setLayoutManager(new GridLayoutManager(this,4,VERTICAL,false));
结果如下所示:
2、StaggeredGridLayoutManager瀑布流效果现在经常会见到,如果只有ListView或者GridView实现的话,有一定难度,但是如果使用RecyclerView则会简单很多,只需要使用StaggeredGridLayoutManager即可实现。我们在MainActivity中,更改使用的布局管理器如下:
//构造器中,第一个参数表示列数或者行数,第二个参数表示滑动方向
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(4,
StaggeredGridLayoutManager.VERTICAL));
当然,只做这些改动是不足够的,因为对于每个Item view来说,它的高度都是一样的,这样就达不到瀑布流的效果了,因此,我们要修改每一个Item View的Height,具体实现逻辑如下所示,
MyAdapter.java:
public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
private List<String> mDataSet;
private List<Integer> mHeight;
public MyAdapter(List<String> data){
mDataSet = data;
mHeight = new ArrayList<Integer>();
//随机获取一个mHeight值
for (int i = 0; i < mDataSet.size(); i++) {
mHeight.add( (int) (100 + Math.random() * 300));
}
}
@Override
public void onBindViewHolder(final ViewHolder holder, int position) {
holder.mTextView.setText(mDataSet.get(position));
//绑定数据的同时,修改每个ItemView的高度
ViewGroup.LayoutParams lp = holder.itemView.getLayoutParams();
lp.height = mHeight.get(position);
holder.itemView.setLayoutParams(lp);
}
...
}
我们来看看结果:
可以看出,使用RecyclerView可以很轻松地实现瀑布流效果。
相信读者读到现在已经能基本使用RecylerView了,包括不同的布局方式的实现等,但由于RecyclerView的可定制性非常高,不是一篇文章可以说完的,因此下篇文章会说详细说说RecyclerView的点击事件的处理,这与一般的ListView的处理点击事件非常不同。
更多阅读:
作者:陈育链接://www.greatytc.com/p/626a082bf569來源:简书著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。