创建Lists与Cards

编写: allenlsy - 原文: https://developer.android.com/training/material/lists-cards.html

要在应用中创建复杂的列表和使用 Material Design 的卡片列表,你可以使用 RecyclerViewCardView

创建列表

RecyclerView 组件是一个更高级和伸缩性更强的 ListView。这个组件是一个显示大量数据的容器,通过维护有限量的View,来达到滚动时的高效。当你的数据集在运行过程中会根据用户行为或网络事件更新时,应该使用 RecyclerView

RecyclerView 通过以下方式简化显示流程,并操作大量数据:

  • 使用 Layout manager 来定位元素
  • 为常用操作定义默认动画,比如添加或移除元素

你也可以为 RecyclerView 自定义 Layout manager 和动画。

创建Lists与Cards - 图1

图1. The RecyclerView widget.

要使用 RecyclerView 组件,你需要定义一个 adapter 和 layout manager。创建 adapter,要继承 RecyclerView.Adapter 类。实现类的细节取决于你的数据集和视图类型。更多信息,请看以下样例。

创建Lists与Cards - 图2

Layout manager把元素视图放在 RecyclerView,并决定什么时候重用不可见的元素视图。要重用(或回收)视图时,layout manager 会让 adapter 用另外的元素内容替换视图内的内容。回收 View 这个方法能提高性能,因为它避免了创建不必要的view对象,或执行昂贵的 findViewById() 查找。

RecyclerView 提供以下内建的 layout manager:

  • LinearLayoutManager 用于显示横向或纵向的滚动列表
  • GridLayoutManager 用于显示方格元素
  • StaggeredGridLayoutManager 在 staggered 方格中显示元素

创建一个自定义的 layout manager,要继承于 RecyclerView.LayoutManager

动画

添加和删除元素的动画在 RecyclerView 中是默认被启用的。要自定义动画,你需要继承RecyclerView.ItemAnimator 类,使用RecyclerView.setItemAnimator()方法。

例子

以下代码示例了如何添加 RecyclerView 到一个 Layout :

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

添加 RecyclerView 组件到Layout之后,获得一个到 RecyclerView 的对象,连接它到 Layout manager,再附上 adapter 用于数据显示:

  1. public class MyActivity extends Activity {
  2. private RecyclerView mRecyclerView;
  3. private RecyclerView.Adapter mAdapter;
  4. private RecyclerView.LayoutManager mLayoutManager;
  5. @Override
  6. protected void onCreate(Bundle savedInstanceState) {
  7. super.onCreate(savedInstanceState);
  8. setContentView(R.layout.my_activity);
  9. mRecyclerView = (RecyclerView) findViewById(R.id.my_recycler_view);
  10. // use this setting to improve performance if you know that changes
  11. // in content do not change the layout size of the RecyclerView
  12. mRecyclerView.setHasFixedSize(true);
  13. // use a linear layout manager
  14. mLayoutManager = new LinearLayoutManager(this);
  15. mRecyclerView.setLayoutManager(mLayoutManager);
  16. // specify an adapter (see also next example)
  17. mAdapter = new MyAdapter(myDataset);
  18. mRecyclerView.setAdapter(mAdapter);
  19. }
  20. ...
  21. }

Adapter 支持获取数据集元素,创建元素的视图,并可以将新元素的内容去替代不可见元素视图中的内容。以下代码展示了一个简单的实现,其中的数据集包含了一个字符串数组,数据元素用 TextView 显示:

  1. public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
  2. private String[] mDataset;
  3. // Provide a reference to the views for each data item
  4. // Complex data items may need more than one view per item, and
  5. // you provide access to all the views for a data item in a view holder
  6. public static class ViewHolder extends RecyclerView.ViewHolder {
  7. // each data item is just a string in this case
  8. public TextView mTextView;
  9. public ViewHolder(TextView v) {
  10. super(v);
  11. mTextView = v;
  12. }
  13. }
  14. // Provide a suitable constructor (depends on the kind of dataset)
  15. public MyAdapter(String[] myDataset) {
  16. mDataset = myDataset;
  17. }
  18. // Create new views (invoked by the layout manager)
  19. @Override
  20. public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent,
  21. int viewType) {
  22. // create a new view
  23. View v = LayoutInflater.from(parent.getContext())
  24. .inflate(R.layout.my_text_view, parent, false);
  25. // set the view's size, margins, paddings and layout parameters
  26. ...
  27. ViewHolder vh = new ViewHolder(v);
  28. return vh;
  29. }
  30. // Replace the contents of a view (invoked by the layout manager)
  31. @Override
  32. public void onBindViewHolder(ViewHolder holder, int position) {
  33. // - get element from your dataset at this position
  34. // - replace the contents of the view with that element
  35. holder.mTextView.setText(mDataset[position]);
  36. }
  37. // Return the size of your dataset (invoked by the layout manager)
  38. @Override
  39. public int getItemCount() {
  40. return mDataset.length;
  41. }
  42. }

创建卡片

创建Lists与Cards - 图3

CardView 继承于 FrameLayout 类,它可以在卡片中显示信息,并保持在不同平台上拥有统一的风格。CardView 组件可以设定阴影和圆角。

要创建一个带阴影的卡片,使用 card_view:cardElevation 属性。CardView 使用了Android 5.0 (API level 21)中的真实高度值以及动态阴影效果,在 5.0 以下的版本中有编程实现阴影的备选方案。更多内容,请参见保持兼容性章节。

使用以下属性来自定义CardView:

  • 使用card_view:cardCornerRadius在layout中设置圆角
  • 使用CardView.setRadius在代码中设置圆角
  • 使用card_view:carBackgroundColor来设置背景颜色

以下代码展示如何在layout中添加CardView:

  1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  2. xmlns:tools="http://schemas.android.com/tools"
  3. xmlns:card_view="http://schemas.android.com/apk/res-auto"
  4. ... >
  5. <!-- A CardView that contains a TextView -->
  6. <android.support.v7.widget.CardView
  7. xmlns:card_view="http://schemas.android.com/apk/res-auto"
  8. android:id="@+id/card_view"
  9. android:layout_gravity="center"
  10. android:layout_width="200dp"
  11. android:layout_height="200dp"
  12. card_view:cardCornerRadius="4dp">
  13. <TextView
  14. android:id="@+id/info_text"
  15. android:layout_width="match_parent"
  16. android:layout_height="match_parent" />
  17. </android.support.v7.widget.CardView>
  18. </LinearLayout>

更多信息,参见CardView的API文档。

添加依赖

RecyclerView和CardView都是v7 support 库的一部分。要使用这两个组件,在你的Gradle依赖中添加两个模块:

  1. dependencies {
  2. ...
  3. compile 'com.android.support:cardview-v7:21.0.+'
  4. compile 'com.android.support:recyclerview-v7:21.0.+'
  5. }