如何在 Android 上使用 RecyclerView：完整的分步指南

  • RecyclerView 允许您高效地显示数据列表或网格。
  • 它由三个关键元素组成：ViewHolder、Adapter、LayoutManager
  • RecyclerView 通过回收不再显示在屏幕上的视图来提高性能
  • 它具有高度可定制性，非常适合动态界面和大型列表
Isaac更新于

6分钟

回收站视图

如果您正在开发 Android 应用程序并需要有效地显示项目列表，RecyclerView 是您的最佳盟友。 这个强大的工具不仅是 ListView 的演变，而且还引入了一种更加模块化和可扩展的方法来显示列表或数据网格。由于其高性能和灵活性，它在开发人员中的使用越来越普遍。

在本文中，我们将深入探讨掌握 RecyclerView 所需了解的所有内容。 从基础到详细实现，包括实用技巧、高级定制以及 Java 和 Kotlin 中的工作示例。如果您正在寻找一站式指南，那么您来对地方了。

什么是 RecyclerView 以及为什么要使用它？

回收视图循环

RecyclerView 是一个 Android 视图组件，可让您以最佳性能显示大量数据。 它旨在回收屏幕上不再可见的视图，避免不必要地创建新视图，从而优化内存使用。

与其前身 ListView 不同， RecyclerView 将其功能划分为可重复使用的小块，为开发人员提供更多控制权。这种基于 ViewHolder 模式的架构可以更好地分离职责，从而产生更清晰、更易于维护和可扩展的代码。要了解有关应用优化的更多信息，请查看我们的指南 Android 中的新工具.

RecyclerView 的主要组件

为了使 RecyclerView 正常工作，您需要实现几个关键部分：

  • RecyclerView： 它是呈现元素的容器。它是一个整合和协调其他部分的ViewGroup。
  • 适配器： 它是数据集和 RecyclerView 之间的桥梁。它负责为每个元素创建和链接视图。
  • ViewHolder： 它负责存储每个元素的视图。通过避免对 findViewById 进行不必要的调用来提高性能。
  • 布局管理器： 定义元素在屏幕上的放置方式。它可以是线性的、网格的、甚至是自定义的。

使用 RecyclerView 的优势

RecyclerView 相较于 ListView 有非常显著的改进：

  • 重用视图： 当视图从屏幕上消失时，它会被回收，从而减少内存消耗。
  • 动画支持： 元素插入、删除和更新的原生动画。
  • 灵活的设计： 使用LayoutManager，您可以显示水平列表、垂直列表、网格，甚至显示不同的项目。
  • CardView集成： 非常适合实现基于 Material Design 的界面。

如何在你的项目中配置 RecyclerView

在编码之前，您必须将必要的依赖项添加到 build.gradle 文件中：

implementation 'androidx.recyclerview:recyclerview:1.4.0' 
implementation 'androidx.cardview:cardview:1.0.0'

确保您使用的版本与您的 minSdk 和 compileSdk 兼容非常重要。例如，RecyclerView 1.4.0 版本要求 API 级别 35 或更高版本才能实现某些功能。

RecyclerView XML 标签

在您的活动或片段 XML 中，像任何其他视图一样定义 RecyclerView：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:clipToPadding="false" />

定义每个元素的布局

每个项目的外观由单独的 XML 文件定义，例如 商品.xml。它可以像 TextView 一样简单，也可以使用带有多个组件的 CardView 变得更复杂。

<androidx.cardview.widget.CardView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:card_view="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    card_view:cardElevation="4dp"
    card_view:cardCornerRadius="8dp"
    android:layout_margin="8dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical"
        android:padding="16dp">

        <TextView
            android:id="@+id/textNombre"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Nombre del producto"
            android:textSize="18sp" />

        <TextView
            android:id="@+id/textDescripcion"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Descripción breve" />

    </LinearLayout>

</androidx.cardview.widget.CardView>

创建 ViewHolder

ViewHolder 是一个封装单个视图及其组件的类。 每次显示一个元素时，适配器将使用分配给该视图的 ViewHolder 实例。详细了解如何使用列表 Android 电视应用.

在 Kotlin 中它会是这样的：

class ProductoViewHolder(view: View): RecyclerView.ViewHolder(view) {
    val nombre: TextView = view.findViewById(R.id.textNombre)
    val descripcion: TextView = view.findViewById(R.id.textDescripcion)
}

创建适配器

Adapter 是 RecyclerView 的核心，因为它将数据连接到视图。它负责创建ViewHolder实例并绑定各个位置的数据。

class ProductosAdapter(private val lista: List<Producto>): RecyclerView.Adapter<ProductoViewHolder>() {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ProductoViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.item_producto, parent, false)
        return ProductoViewHolder(view)
    }

    override fun getItemCount(): Int = lista.size

    override fun onBindViewHolder(holder: ProductoViewHolder, position: Int) {
        val producto = lista
        holder.nombre.text = producto.nombre
        holder.descripcion.text = producto.descripcion
    }
}

任何适配器的三个必需方法是：

  • 创建ViewHolder： 每个项目的布局膨胀。
  • onBindViewHolder： 将数据绑定到 ViewHolder。
  • 获取项目数量： 返回元素的总数。

使用 LayoutManager

LayoutManager 定义项目在 RecyclerView 中的放置方式。 Android 默认为我们提供了几个选项：

  • 线性布局管理器： 垂直或水平列表。
  • 网格布局管理器： 列或行的网格。
  • 交错网格布局管理器： 网格允许不同大小的元素，非常适合 Pinterest 类型的设计。

在您的活动中初始化 RecyclerView

完成上述所有定义后，您需要在文件中配置 RecyclerView 主要活动.kt o 主活动.java:

val recyclerView = findViewById<RecyclerView>(R.id.recyclerView)
recyclerView.layoutManager = LinearLayoutManager(this) // o GridLayoutManager
recyclerView.adapter = ProductosAdapter(listaDeProductos)

捕获元素上的点击事件

使用 RecyclerView 时最常见的问题之一是如何捕获用户交互。 主要有两种方式：

  1. 从适配器内部： 它很简单，但不太灵活。
  2. 从适配器外部使用接口： 这是最推荐的方法。

捕获点击的界面示例：

interface OnProductoClickListener {
    fun onProductoClick(producto: Producto)
}

您的适配器将接收此接口作为参数，并从方法 onBindViewHolder 你将执行该方法 onProductoClick 当单击该项目时。如果您正在寻找更多用户事件的示例，您可以探索 如何在 Android Auto 上收听广播.

高级 RecyclerView 自定义

除了显示列表之外，RecyclerView 还允许进行以下自定义：

  • 不同类型的项目的多个视图： 非常适合混合横幅、产品、促销、广告等。
  • 自定义动画： 您可以在添加或删除元素时定义自己的动画。
  • 装饰物： 使用 ItemDecoration 您可以定义元素之间的边距、分隔符或线条。
  • 无限滚动： 当到达 RecyclerView 末尾时实现渐进式加载。

RecyclerView 可以处理任何数据集，从简单的文本数组到具有多个属性（如图像、操作、描述、价格等）的更复杂的对象列表。不要忘记，为了优化列表的使用，您可以查看一些有用的应用程序，例如 在 Android 上制定计划的免费应用.

RecyclerView 只能与 CardView 配合使用吗？

不。虽然通常一起使用它们来遵循 Material Design 指南， 您可以使用项目中的任何布局：LinearLayout、ConstraintLayout、FrameLayout等。

重要的是定义一个 XML 文件来表示每个元素的外观。

更新和兼容性

RecyclerView 的较新版本（例如 1.4.0）， 包括性能改进、新 API 以及与其他 Android Jetpack 库更好的集成.

一些重要新闻：

  • 自适应刷新率支持。
  • 复杂动画中的优化。
  • 增强了与 Jetpack Compose 和 ViewPager2 的互操作性。

RecyclerView 的常见用例

RecyclerView 用途极其广泛。 以下是一些典型的使用示例：

  • 联系人列表或消息。
  • 在线商店中的产品网格。
  • 动态新闻或博客文章。
  • 画廊中的图像。
  • 多媒体元素，例如视频或音频。

复杂的应用程序可以有多个嵌套的 RecyclerView，每个都有自己特定的配置。显示多媒体内容的良好资源是 在 Android 电视盒上观看 DTT.

RecyclerView 的最佳实践

使用 RecyclerView 时，请记住以下提示：

  • 使用 ViewBinding o DataBinding 以避免 findViewById 出现错误。
  • 如果仅更改一项，请避免更新整个列表。
  • 不要在 onBindViewHolder 内部进行昂贵的操作。提前准备好数据。
  • 如果有多种类型的视图，请使用 getItemViewType() 正确地

RecyclerView不仅是现代Android开发中必不可少的组件，也是构建许多直观、有效界面的基础。 它的多功能性、性能和模块化使其非常适合需要显示重复或动态内容的任何应用程序。通过结构化的实现，您可以实现强大的界面，提供流畅、专业的用户体验。

什么是 WhatsApp-5 个性化列表及其工作原理？
相关文章：
如何使用个性化 WhatsApp 列表组织您的聊天

发表您的评论

您的电子邮件地址将不会被发表。 必填字段标有 *

*

*