安装设置

列表或网格中元素的显示是移动应用程序中非常常见的模式。用户看到一组项目并可以滚动它们。项目集合可以是列表,网格或数据的其他结构化表示。

RecyclerView 小部件是 ListView 的更高级和灵活的版本。此窗口小部件是一个容器,用于显示可以通过维护有限数量的视图而非常有效地滚动的大型数据集。如果数据集合的元素在运行时根据用户操作或网络事件而更改,请使用 RecyclerView 小部件。

RecyclerView 类通过提供以下内容简化了大型数据集的显示和处理:

  • 布局管理器用于定位项目
  • 常用项操作的默认动画,例如删除或添加项

你还可以灵活地为 RecyclerView 小部件定义自定义布局管理器和动画。

StackOverflow 文档

要使用 RecyclerView 小部件,你必须指定适配器和布局管理器。要创建适配器,请扩展 RecyclerView.Adapter 类。实现的细节取决于数据集的细节和视图的类型。

StackOverflow 文档

布局管理器将项目视图放置在 RecyclerView 内,并确定何时重用用户不再可见的项目视图。要重用(或回收)视图,布局管理器可能会要求适配器使用与数据集不同的元素替换视图的内容。以这种方式回收视图可以避免创建不必要的视图或执行昂贵的 findViewById() 查找,从而提高性能。

RecyclerView 提供了这些内置的布局管理器:

要创建自定义布局管理器,请扩展 RecyclerView.LayoutManager 类。

现在要添加 RecyclerView,你需要在 build.gradle 中添加以下依赖项

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

现在在你的布局中添加一个 RecyclerView 就像这样。

<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;
    }
}

首先将支持库添加到项目中:在应用程序的 build.gradle 文件中,添加依赖项。

https://developer.android.com/reference/android/widget/ListView.html