可滚动列表有助于管理数据集、创建响应式设计和简化导航。您可以使用有限滚动列表在应用中显示较小的项目集。要避免处理大型数据集或长度未知列表时出现的性能问题,请参阅使用列表和 Paging 延迟加载数据。
版本兼容性
此实现要求您的项目的 minSDK 设置为 API 级别 21 或更高版本。
依赖项
创建垂直滚动列表
使用以下代码创建垂直滚动列表
@Composable private fun ScrollBoxes() { Column( modifier = Modifier .background(Color.LightGray) .size(100.dp) .verticalScroll(rememberScrollState()) ) { repeat(10) { Text("Item $it", modifier = Modifier.padding(2.dp)) } } }
关于代码的关键点
- 使用
verticalScroll
修饰符和rememberScrollState
函数设置Column
的滚动行为。 - 要创建水平滚动列表,请创建一个带有
horizontalScroll
修饰符的Row
。
结果

包含此指南的集合
本指南是这些精心策划的快速指南集合的一部分,这些集合涵盖了更广泛的 Android 开发目标

显示列表或网格
列表和网格使您的应用能够以视觉上令人愉悦的形式显示集合,方便用户使用。

显示互动组件
了解可组合函数如何帮助您轻松创建基于 Material Design 设计系统的精美 UI 组件。

Compose 基础知识(视频合集)
本系列视频介绍了各种 Compose API,快速向您展示了有哪些可用 API 以及如何使用它们。
有问题或反馈?
请访问我们的常见问题页面,了解快速指南;或联系我们,告诉我们您的想法。