35.RecyclerView （更强大的滚动控件）【基本】

一、RecyclerView 的定义

RecyclerView 是 Android 提供的用于显示大量数据列表的强大组件。与传统的 ListView 不同，RecyclerView 内置了视图复用（回收）和更灵活的布局管理器，使得列表滚动更加流畅，同时也便于实现复杂的列表效果和动画。

二、RecyclerView 的基本组成部分

1. RecyclerView

   • 这是一个 ViewGroup，用于显示数据列表。你可以在布局文件中添加 RecyclerView。

2. LayoutManager

   • 控制 RecyclerView 中列表项的布局形式。目前常用的有：
     • LinearLayoutManager：垂直或水平的线性排列。
     • GridLayoutManager：网格布局。
     • StaggeredGridLayoutManager：交错网格布局。

3. Adapter

   • 负责连接数据和 RecyclerView，将数据绑定到列表项视图上。你需要继承 RecyclerView.Adapter 并实现必要的方法。

4. ViewHolder

   • 用于缓存每个列表项内部的视图引用。这样可以避免重复调用 findViewById 操作，从而提升滚动性能。你需要创建一个继承自 RecyclerView.ViewHolder 的内部类，并在其中获取列表项内的视图控件。

三、RecyclerView 的使用步骤

下面简单介绍一下创建一个 RecyclerView 一般需要经过的几个步骤：

1. 在布局文件中添加 RecyclerView

   首先在你的 Activity_main。例如：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp">

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

</LinearLayout>

创建列表项的布局

为了显示每个数据项的内容，我们需要编写一个列表项的 XML 布局文件，例如 item_view.xml：

<!-- res/layout/item_view.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="8dp">

    <TextView
        android:id="@+id/textViewItem"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="示例文本"
        android:textSize="18sp" />
</LinearLayout>

创建 Adapter 子类

编写一个适配器类，用来创建和绑定 ViewHolder。适配器负责将数据加载到每个列表项视图上。

package com.example.myapplication41

import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.TextView
import androidx.recyclerview.widget.RecyclerView

// 自定义适配器，传入显示数据的集合
/*
定义了 Adapter 类，继承自 RecyclerView.Adapter
    泛型参数是自定义的 MyViewHolder。Adapter 类需要一个 items 列表作为数据源。
 */
class Adapter(private val items: List<String>) :
    RecyclerView.Adapter<Adapter.MyViewHolder>() {

    // 定义 ViewHolder 类，缓存列表项中的控件引用
        /*
        定义了 MyViewHolder 内部类，继承自 RecyclerView.ViewHolder。MyViewHolder 用于缓存列表项中的控件引用。
        itemView：表示列表项的根视图。
        textView：通过 findViewById 查找并缓存 TextView 控件，避免重复查找。
         */
    class MyViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val textView: TextView = itemView.findViewById(R.id.textViewItem)
    }

    // 创建新视图（由布局管理器调用）
    /*
    重写 onCreateViewHolder 方法，用于创建新的视图并返回 MyViewHolder 对象。
    parent：即 RecyclerView 本身，用于提供上下文。
    viewType：视图类型（通常用于多类型布局）。
    LayoutInflater.from(parent.context)：获取 LayoutInflater 实例。
    inflate(R.layout.item_view, parent, false)：将 item_view.xml 布局文件转换为 View 对象。
    MyViewHolder(view)：使用创建的视图对象实例化 MyViewHolder 对象，并返回。
     */
    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
        // 将列表项布局转换为 View 对象
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_view, parent, false)
        return MyViewHolder(view)
    }

    // 将数据与视图组合在一起
    /*
    重写 onBindViewHolder 方法，将数据绑定到视图上
    holder：MyViewHolder 对象，持有当前列表项的视图。
    position：当前列表项的位置。
    holder.textView.text = items[position]：从数据源中取出对应位置的数据，设置到 TextView 上。
     */
    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        // 获取当前 position 数据，并设置到文本控件
        holder.textView.text = items[position]
    }

    // 返回数据项的数量
    override fun getItemCount(): Int {
        return items.size
    }
}

在 Activity（或 Fragment）中配置 RecyclerView

在你的 Activity 的 onCreate 方法中，初始化 RecyclerView、设置布局管理器和适配器：

// MainActivity.kt
package com.example.myapplication41

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.recyclerview.widget.LinearLayoutManager
import androidx.recyclerview.widget.RecyclerView

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 获取 RecyclerView 控件
        val recyclerView: RecyclerView = findViewById(R.id.recyclerView)

        // 初始化数据，这里使用一组简单的字符串
        val data = listOf("项目 1", "项目 2", "项目 3", "项目 4", "项目 5")

        // 设置 LayoutManager，决定列表如何排列。这里使用垂直线性布局
        recyclerView.layoutManager = LinearLayoutManager(this)

        // 设置自定义适配器，将数据源传入
        recyclerView.adapter = Adapter(data)
    }
}

• RecyclerView 定义：用于高效地显示大量数据，并具备丰富的布局和动画效果。
• 基本组成部分：包括 RecyclerView 本身、LayoutManager、Adapter 和 ViewHolder。
• 使用流程：在布局文件中添加 RecyclerView，定义列表项布局，编写自定义适配器并创建 ViewHolder，然后在 Activity 中配置 RecyclerView 的布局管理器和适配器。