Android RecyclerView 简介与使用

一、Material Design 风格的 RecyclerView

RecyclerView 是作为 ListView 和 GridView 的替代者出现的，RecyclerView 小部件比 ListView 更高级且更具灵活性。它是一个用于显示庞大数据集的容器，可通过保持有限数量的视图进行非常有效的滚动操作。数据集合中的元素可以因用户操作或网络事件而在运行时发生改变。

RecyclerView 类别将通过提供下列功能简化庞大数据集的显示与处理：

用于项目定位的布局管理器（LayoutManager）
用于通用项目操作（例如删除或添加项目）的默认动画

可以自定义布局管理器与动画。

RecyclerView 小部件

如果要使用 RecyclerView 小部件，必须指定一个适配器和一个布局管理器。 如果要创建一个适配器，请扩展 RecyclerView.Adapter 类别。实现的详情将取决于数据集的具体信息以及视图的类型。

一个 RecyclerView 的 Adapter 大致如下：

public class RecyclerAdapter extends RecyclerView.Adapter<RecyclerAdapter.RecyclerViewHolder> {
    List<String> mDataSet = new ArrayList<String>();

    @Override
    public RecyclerViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        //创建ViewHolder
        View v = LayoutInflater.from(parent.getContext()).inflate(R.layout.activity_main, parent, false);
        RecyclerViewHolder recyclerViewHolder = new RecyclerViewHolder(v);
        return recyclerViewHolder;
    }

    @Override
    public void onBindViewHolder(RecyclerViewHolder holder, int position) {
        //绑定数据
        holder.nameTv.setText(mDataSet.get(position));
    }

    @Override
    public int getItemCount() {
        return mDataSet.size();
    }

    //自定义的ViewHolder，实例化 Item View 的视图
    static class RecyclerViewHolder extends RecyclerView.ViewHolder {
        TextView nameTv;

        public RecyclerViewHolder(View itemView) {
            super(itemView);
            nameTv = itemView.findViewById(R.id.username_tv);
        }
    }
}

二、布局管理器

布局管理器将确定 RecyclerView 内各项目视图的位置并决定何时重新使用用户已不可见的项目视图。如果要重新使用（或重复使用）一个视图，布局管理器可能会要求适配器用数据集中的另一个元素替换视图的内容。以此方式重复使用视图将可避免创建不必要的视图或执行成本高昂的 findViewById() 查找，从而改善性能。

RecyclerView 提供这些内置布局管理器：

LinearLayoutManager 以垂直或水平滚动列表方式显示项目。
GridLayoutManager 在网格中显示项目。
StaggeredGridLayoutManager 在分散对齐网格中显示项目。

如果要创建一个自定义布局管理器，需要扩展 RecyclerView.LayoutManager 类。

三、动画

RecyclerView 对于 Item View 的控制更为精细，可以通过 ItemDecoration 为 Item View 添加装饰，即对 Item View 进行二次加工；也可以通过 ItemAnimator 为 Item View 添加动画。

RecyclerView 在默认情况下启用增添与删除项目的动画。若要自定义这些动画，请扩展 RecyclerView.ItemAnimator 类并使用 RecyclerView.setItemAnimator() 方法。

示例

使用之前必须先添加依赖项

dependencies {
    ...
    compile 'com.android.support:recyclerview-v7:21.0.+'
}

下列代码示例将展示如何将 RecyclerView 添加至布局：

<!-- A RecyclerView with some commonly used attributes -->
<android.support.v7.widget.RecyclerView
    android:id="@+id/my_recycler_view"
    android:scrollbars="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

将 RecyclerView 添加至布局后，立即获取对象图柄并将其连接至布局管理器，同时附加一个适配器以便显示数据：

public class MyActivity extends Activity {
    private RecyclerView mRecyclerView;
    private RecyclerView.Adapter mAdapter;
    private RecyclerView.LayoutManager mLayoutManager;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.my_activity);
        mRecyclerView = (RecyclerView) findViewById(R.id.my_recycler_view);

        // use this setting to improve performance if you know that changes
        // in content do not change the layout size of the RecyclerView
        mRecyclerView.setHasFixedSize(true);

        // use a linear layout manager
        mLayoutManager = new LinearLayoutManager(this);
        mRecyclerView.setLayoutManager(mLayoutManager);

        // specify an adapter (see also next example)
        mAdapter = new MyAdapter(myDataset);
        mRecyclerView.setAdapter(mAdapter);
    }
    ...
}

适配器可以存取数据集中的项目，为项目创建视图，并且在原始项目不再可见时以新数据项目替换视图的某些内容。

下列代码示例将展示一个简单的实现，目标为一个包含使用 TextView 小部件显示的字符串阵列的数据集：

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
    private String[] mDataset;

    // Provide a reference to the views for each data item
    // Complex data items may need more than one view per item, and
    // you provide access to all the views for a data item in a view holder
    public static class ViewHolder extends RecyclerView.ViewHolder {
        // each data item is just a string in this case
        public TextView mTextView;
        public ViewHolder(TextView v) {
            super(v);
            mTextView = v;
        }
    }

    // Provide a suitable constructor (depends on the kind of dataset)
    public MyAdapter(String[] myDataset) {
        mDataset = myDataset;
    }

    // Create new views (invoked by the layout manager)
    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent,
                                                   int viewType) {
        // create a new view
        View v = LayoutInflater.from(parent.getContext())
                               .inflate(R.layout.my_text_view, parent, false);
        // set the view's size, margins, paddings and layout parameters
        ...
        ViewHolder vh = new ViewHolder(v);
        return vh;
    }

    // Replace the contents of a view (invoked by the layout manager)
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        // - get element from your dataset at this position
        // - replace the contents of the view with that element
        holder.mTextView.setText(mDataset[position]);

    }

    // Return the size of your dataset (invoked by the layout manager)
    @Override
    public int getItemCount() {
        return mDataset.length;
    }
}