一、概述

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'
}
  1. 在对应的布局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>
  1. 设置布局管理器(必要):
    官方给出了三种布局管理器,都是继承于RecyclerView.LayoutManager:
java.lang.Object
   ↳    android.support.v7.widget.RecyclerView.LayoutManager

Known Direct Subclasses
LinearLayoutManager, StaggeredGridLayoutManager

Known Indirect Subclasses
GridLayoutManager

设置接口很简单(根据需求下面三选一):

  • LinearLayoutManager,实现效果和Listview完全一致:
mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
  • GridLayoutManager,可以实现GridView的效果:
mRecyclerView.setLayoutManager(new GridLayoutManager(this, 4, LinearLayoutManager.VERTICAL, false));

这里构造方法中给了四个参数:第一个是上下文,第二个是指定行数(列数),第三个是指定水平排列还是垂直排列,第四个参数设置从底部往顶部排列(true)还是顶部往底部排列(false),当然也提供了两个参数的构造方法,请自行查看,设置了相关默认值;

  • StaggeredGridLayoutManager,瀑布流式布局管理器:
mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(6, StaggeredGridLayoutManager.VERTICAL));

这里构造方法中参数很好理解分别是行数(列数)和排列方向,实现效果如下图:

a、设置垂直排列布局,在Adapter的onBindViewHolder回调中设置每个Item的高度模拟瀑布流UI效果:

mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));

Android Release包 如何获得View树_android

注意点:我设置两列时候,数据排列顺序是水平从左到右放置的,垂直方向上可以实现滚动;

b、设置水平排列布局:

mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(8, StaggeredGridLayoutManager.HORIZONTAL));

Android Release包 如何获得View树_xml_02

注意点:我设置的是8行,数据排列顺序是从上到下展示,水平方向上可以实现滚动;

  1. 设置适配器(必要),可以同时实现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;

  1. 设置Item的移除和增加动画(非必要):
mRecyclerView.setItemAnimator(new DefaultItemAnimator());

这里使用的是系统提供的一个默认动画,效果如下图(同时可以看到上面设置的点击事件监听):

Android Release包 如何获得View树_xml_03


注意点:这里演示了三个事件,分别是添加,移除,点击事件;

添加事件:和ListView一样需要改变在数据源的相应位置添加对应数据,然后notify,但是这里要用上动画,需要使用RecyclerView.Adapter中的这个接口:


notifyItemInserted(position);
java
移除事件:同添加一样,改变数据源之后,调用RecyclerView.Adapter中的这个接口:

notifyItemRemoved(position);
  1. 设置分隔线(非必要):
mRecyclerView.addItemDecoration(RecyclerView.ItemDecoration);

这里设置分割线的方式需要写一个继承于RecyclerView.ItemDecoration的实体类,然后去画分割线,有些繁琐,如果只是简单的分割线,直接在Item的xml布局中设置Margin或者画出一个自己想要的View即可。

三、总结:

可以看出RecyclerView除了可以实现ListView,GridView效果外还可以轻松实现瀑布流的UI展示界面,只不过RecyclerView的高度解耦,内部只做了recycle的事情,交由外部定制的东西有些多,需要我们实现:
1、设置布局管理器(必须);
2、设置适配器(必须);
3、设置点击事件(如需);
4、设置Item的移除和增加动画(如需);
5、设置分隔线(如需);