Android 之 RecyclerView 显示数据列表

原创

已于 2025-07-17 16:32:51 修改 · 1.2k 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#android #kotlin #列表

于 2024-12-13 19:24:56 首次发布

一、RecyclerView的优势

RecyclerView 的最大优势在于，它对大型列表来说非常高效：

默认情况下，RecyclerView 仅会处理或绘制当前显示在屏幕上的项。例如，如果您的列表包含一千个元素，但只有 10 个元素可见，那么 RecyclerView 仅会完成在屏幕上绘制这 10 个项的工作。当用户滚动时，RecyclerView 会确定应在屏幕上显示哪些新项，然后仅完成显示这些项的工作。
当某个项滚动出屏幕时，RecyclerView 会回收其视图。也就是说，这个项中会填充滚动到屏幕上的新内容。RecyclerView 的这种行为可以节省大量处理时间，并能让列表顺畅地滚动。
当某个项发生变化时，RecyclerView 无需重新绘制整个列表即可更新该项。在显示包含复杂项的长列表时，这可以极大地提高效率！

二、RecyclerView中显示数据的步骤

如需在 RecyclerView 中显示您的数据，您需要以下几个部分：

要显示的数据。即列表项中要显示的内容。
在布局文件中定义的一个 RecyclerView 实例，用作视图的容器。RecyclerView包含与您的数据对应的视图的 ViewGroup，它本身是一个视图，因此，将 RecyclerView 添加到布局中的方式与添加任何其他界面元素相同。
一个数据项的布局。如果所有列表项看起来都一样，您可以对所有这些列表项使用相同的布局，但这不是强制性要求。项布局必须与 fragment 的布局分开创建，以便一次创建一个项视图，并在其中填充数据。
一个布局管理器。布局管理器负责排列列表中的各个元素。您可以使用 RecyclerView 库提供的某个布局管理器，也可以定义自己的布局管理器。布局管理器均基于库的 LayoutManager 抽象类。
一个 ViewHolder。该 ViewHolder 用于扩展 ViewHolder 类。它包含视图信息，用于显示项布局中的一项。ViewHolder 还会添加一些信息，供 RecyclerView 用于在屏幕上高效移动视图。可以通过扩展 RecyclerView.ViewHolder 来定义 ViewHolder。
一个适配器。该适配器可将您的数据与 RecyclerView 相关联。它会调整数据，使其可在 ViewHolder 中显示。RecyclerView 会使用适配器确定如何在屏幕上显示数据。可以通过扩展 RecyclerView.Adapter 来定义 Adapter。

三、实现RecyclerView

1. 添加依赖项

在模块的 build.gradle 中添加 RecyclerView 的依赖项：

	implementation("androidx.recyclerview:recyclerview:1.3.2")

2. 准备要显示的数据

本例只是演示 RecyclerView 的用法，故只简单显示颜色列表，数据项中只需定义一个 TextView 来显示颜色即可。实际项目中需根据需求定义相应的数据类来保存列表项内容。

	val listData = arrayOf("yellow", "red", "blue")

3. 在 xml 中添加RecyclerView组件

布局 recyclerview_main.xml

	<androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerview"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content" />

4. 创建列表项布局

本例中 RecyclerView 显示了一个简单的文本元素列表，每个视图项的布局在xml中定义，item_recyclerview.xml 布局如下：

	<?xml version="1.0" encoding="utf-8"?>
	<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
	    android:layout_width="match_parent"
	    android:layout_height="40dp">
	    
	    <TextView
	        android:id="@+id/tv_text"
	        android:layout_width="wrap_content"
	        android:layout_height="wrap_content"
	        android:text="@string/element_text"
	        android:gravity="center_vertical"/>
	
	</FrameLayout>

5. 选择布局管理器

RecyclerView 中的列表项由 LayoutManager 类负责排列。RecyclerView 库提供了三种布局管理器，用于处理最常见的布局情况：

LinearLayoutManager 将各个项排列在一维列表中。
GridLayoutManager 将项排列在二维网格中：
- 如果网格垂直排列，GridLayoutManager 会尽量使每行中所有元素的宽度和高度相同，但不同的行可以有不同的高度。
  - 如果网格水平排列，GridLayoutManager 会尽量使每列中所有元素的宽度和高度相同，但不同的列可以有不同的宽度。
StaggeredGridLayoutManager 与 GridLayoutManager 类似，但不要求同一行中的表项具有相同的高度（垂直网格有此要求）或同一列中的列表项具有相同的宽度（水平网格有此要求）。其结果是，同一行或同一列中的列表项可能会错落不齐。