原生移动开发 / 系统课时

LazyColumn 与 LazyRow

LazyColumn 与 LazyRow

当列表拥有几十、几百甚至更多条数据时,不应再用 Column.verticalScroll 或 Row.horizontalScroll 一次组合全部子项。本节使用 LazyColumn 和 LazyRow 构建纵向、横向列表,并通过稳定 key 保持项目身份。

学习目标

  • 使用 LazyColumn、LazyRow 与 items 渲染集合数据
  • 理解惰性列表只组合可见区域附近项目的工作方式
  • 使用稳定 key 降低列表重排时的状态错位风险

惰性列表只处理需要显示的项目

LazyColumn 和 LazyRow 的核心区别不在“能滚动”,而在“按需组合”。列表的数据源可以很大,但 Compose 不需要在首次进入页面时把所有项目都完整组合出来,而是围绕当前可视窗口创建需要显示的内容。

LazyColumn 可视窗口与按需组合关系

这种机制非常适合动态数据列表。它不会改变业务数据本身,只是改变 UI 项目的创建时机。

组合纵向和横向列表

下面示例在顶部使用 LazyRow 展示分类,在下方使用 LazyColumn 展示 200 个产品。代码可直接放入已启用 Jetpack Compose 的 Android 项目中。

kotlin
package com.example.lazysample

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.weight
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.LazyRow
import androidx.compose.foundation.lazy.items
import androidx.compose.material3.Card
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp

data class Product(val id: Int, val name: String)

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MaterialTheme {
                ProductScreen()
            }
        }
    }
}

@Composable
fun ProductScreen() {
    val categories = listOf("推荐", "手机", "电脑", "配件", "家居", "图书")
    val products = List(200) { index ->
        Product(id = index + 1, name = "产品 ${index + 1}")
    }

    Column(
        modifier = Modifier
            .fillMaxSize()
            .padding(16.dp)
    ) {
        LazyRow(
            modifier = Modifier.height(52.dp),
            horizontalArrangement = Arrangement.spacedBy(8.dp)
        ) {
            items(categories) { category ->
                Card {
                    Text(category, modifier = Modifier.padding(12.dp))
                }
            }
        }

        LazyColumn(
            modifier = Modifier
                .fillMaxWidth()
                .weight(1f),
            verticalArrangement = Arrangement.spacedBy(8.dp)
        ) {
            items(
                items = products,
                key = { product -> product.id }
            ) { product ->
                Card(modifier = Modifier.fillMaxWidth()) {
                    Text(
                        text = "${product.id}. ${product.name}",
                        modifier = Modifier.padding(16.dp)
                    )
                }
            }
        }
    }
}

预期结果

text
页面顶部出现可左右滑动的分类条;下方出现可上下滑动的产品列表,能够连续浏览“产品 1”到“产品 200”。

LazyRow 被限制为固定高度,LazyColumn 通过 weight(1f) 获得剩余空间,因此两个滚动区域都有明确边界,也不会互相争夺同一方向的滚动。

key 用来描述项目身份

items 可以接收 key。当列表会插入、删除或重新排序时,稳定 key 能帮助 Compose 识别“这是原来的哪一个项目”,从而更可靠地保留与项目相关的状态。

示例使用 product.id 作为 key,前提是同一列表中它必须唯一且稳定。不要把当前索引当作可重排数据的长期身份,因为项目位置变化后,索引也会变化。

在 LazyColumn 中组织不同类型内容

惰性列表不仅能渲染集合,还能插入单个项目。例如可以先用 item { ... } 放标题,再用 items(...) 渲染数据,再追加一个尾部提示。这样同一个滚动容器可以承载不同类型内容,而不必再套一层同方向 verticalScroll。

需要分页加载、滚动位置控制或“滚到底加载更多”时,也应继续基于 LazyColumn、LazyRow 及其状态对象扩展,而不是退回一次性组合全部内容的普通滚动容器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

LazyColumn 与 LazyRow

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通