扩展 RecyclerView 示例

项目
07/13/2018

基本 RecyclerView 示例中描述的基本应用实际上没有太多用处 - 它只是可以滚动并显示固定的照片项目列表以方便浏览。在实际应用程序中，用户希望能够通过点击显示中的项来与应用交互。此外，基础数据源可以更改（或由应用更改），并且显示的内容必须与这些更改保持一致。在以下部分中，你将了解如何处理项单击事件并在基础数据源更改时更新 RecyclerView。

处理项单击事件

当用户触摸 RecyclerView 中的某个项时，系统会生成一个项单击事件，以通知应用访问了哪个项。该事件不是由 RecyclerView 生成的，相反，项视图（包装在视图持有者中）将检测这些触摸并会将这些触摸报告为单击事件。

为了说明如何处理项单击事件，以下步骤解释了如何修改基本照片查看应用以报告用户触摸了哪张照片。当示例应用中发生项单击事件时，会发生以下序列：

照片的 CardView 检测到项单击事件，并通知适配器。
适配器将事件（带有项位置信息）转发到活动的项单击处理程序。
活动的项单击处理程序响应项单击事件。

首先，将调用 ItemClick 的事件处理程序成员添加到 PhotoAlbumAdapter 类定义中：

public event EventHandler<int> ItemClick;

接下来，将项单击事件处理程序方法添加到 MainActivity 中。此处理程序会短暂显示一个 Toast，指示触摸了哪个照片项：

void OnItemClick (object sender, int position)
{
    int photoNum = position + 1;
    Toast.MakeText(this, "This is photo number " + photoNum, ToastLength.Short).Show();
}

接下来，需要一个代码行才能将 OnItemClick 处理程序注册到 PhotoAlbumAdapter。创建 PhotoAlbumAdapter 后，可以立即执行此操作：

mAdapter = new PhotoAlbumAdapter (mPhotoAlbum);
mAdapter.ItemClick += OnItemClick;

在此基本示例中，处理程序注册发生在主活动的 OnCreate 方法中，但生产应用可能会在 OnResume 中注册此处理程序并在 OnPause 中取消其注册 - 有关详细信息，请参阅活动生命周期。

PhotoAlbumAdapter 现在将在收到项单击事件时调用 OnItemClick。下一步是在引发此 ItemClick 事件的适配器中创建处理程序。以下 OnClick 方法会添加到适配器的 ItemCount 方法后面：

void OnClick (int position)
{
    if (ItemClick != null)
        ItemClick (this, position);
}

此 OnClick 方法是适配器的侦听器，用于侦听项视图中的项单击事件。将此侦听器（通过项视图的视图持有者）注册到项视图之前，必须修改 PhotoViewHolder 构造函数以接受此方法作为附加参数，并向项视图 Click 事件注册 OnClick。下面是修改后的 PhotoViewHolder 构造函数：

public PhotoViewHolder (View itemView, Action<int> listener)
    : base (itemView)
{
    Image = itemView.FindViewById<ImageView> (Resource.Id.imageView);
    Caption = itemView.FindViewById<TextView> (Resource.Id.textView);

    itemView.Click += (sender, e) => listener (base.LayoutPosition);
}

itemView 参数包含对用户触摸的 CardView 的引用。请注意，视图持有者基类知道它所表示的项 (CardView) 的布局位置（通过 LayoutPosition 属性），并且当发生项单击事件时，该位置将传递给适配器的 OnClick 方法。修改适配器的 OnCreateViewHolder 方法，使其将适配器的 OnClick 方法传递给视图持有者的构造函数：

PhotoViewHolder vh = new PhotoViewHolder (itemView, OnClick);

现在，生成并运行示例照片查看应用时，点击显示中的照片将出现 Toast，报告触摸了哪张照片：

此示例只演示了一种使用 RecyclerView 实现事件处理程序的方法。这里可以使用的另一种方法是将事件放置在视图持有者上并让适配器订阅这些事件。如果示例照片应用提供了照片编辑功能，则每个 CardView 中的 ImageView 和 TextView 都需要单独的事件：触摸 TextView 会启动 EditView 对话框，让用户可以编辑标题，触摸 ImageView 会启动照片修饰工具，让用户可以裁剪或旋转照片。根据应用的需求，必须制定处理和响应触摸事件的最佳方法。

要演示如何在数据集更改时更新 RecyclerView，可以修改示例照片查看应用以随机选择数据源中的一张照片并将其与第一张照片交换。首先，将“随机选取”按钮添加到示例照片应用的 Main.axml 布局中：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    <Button
        android:id="@+id/randPickButton"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:gravity="center_horizontal"
        android:textAppearance="?android:attr/textAppearanceLarge"
        android:text="Random Pick" />
    <android.support.v7.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:scrollbars="vertical"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent" />
</LinearLayout>

接下来，在主活动的 OnCreate 方法末尾添加代码，以在布局中找到 Random Pick 按钮，并将处理程序附加到该按钮：

Button randomPickBtn = FindViewById<Button>(Resource.Id.randPickButton);

randomPickBtn.Click += delegate
{
    if (mPhotoAlbum != null)
    {
        // Randomly swap a photo with the first photo:
        int idx = mPhotoAlbum.RandomSwap();
    }
};

点击“随机选取”按钮时，此处理程序将调用相册的 RandomSwap 方法。 RandomSwap 方法会随即选取一张照片并将其与数据源中的第一张照片交换，然后返回随机交换的照片的索引。使用此代码编译并运行示例应用时，点击“随机选取”按钮不会导致显示更改，因为 RecyclerView 未识别对数据源所做的更改。

要在数据源更改后更新 RecyclerView，必须修改“随机选取”单击处理程序，以便为集合中已更改的每个项调用适配器的 NotifyItemChanged 方法（在本例中，有两个项已更改：第一张照片和交换的照片）。这会导致 RecyclerView 更新其显示，使其与数据源的新状态保持一致：

Button randomPickBtn = FindViewById<Button>(Resource.Id.randPickButton);

randomPickBtn.Click += delegate
{
    if (mPhotoAlbum != null)
    {
        int idx = mPhotoAlbum.RandomSwap();

        // First photo has changed:
        mAdapter.NotifyItemChanged(0);

        // Swapped photo has changed:
        mAdapter.NotifyItemChanged(idx);
    }
};

现在，点击“随机选取”按钮时， 将更新显示，表明集合中更靠后的照片已与集合中的第一张照片交换RecyclerView：

当然，可以调用 NotifyDataSetChanged，而不是分两次调用 NotifyItemChanged，但这样做会强制 RecyclerView 刷新整个集合，即使集合中只有两项发生了更改也是如此。调用 NotifyItemChanged 比调用 NotifyDataSetChanged 更高效。

通过

扩展 RecyclerView 示例

处理项单击事件

相关链接

其他资源