滚动列表有助于管理数据集、创建自适应设计,并简化导航。您可以使用有限滚动列表在应用中显示较少数量的项。如需避免较大数据集或长度未知的列表出现性能问题,请参阅使用列表和分页延迟加载数据。
版本兼容性
此实现要求将项目 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
。
结果
![响应滚动手势的垂直列表](https://developer.android.google.cn/static/develop/ui/compose/images/gestures-simplescroll.gif?hl=zh-cn)
包含本指南的集合
本指南属于以下精选快速入门集合,这些集合涵盖了更广泛的 Android 开发目标:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=zh-cn)
显示列表或网格
借助列表和网格,您的应用可以以视觉上令人愉悦且易于用户使用的形式显示集合。
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=zh-cn)
显示互动组件
了解如何使用可组合函数根据 Material Design 设计系统轻松创建美观的界面组件。
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=zh-cn)
Compose 基础知识(视频合集)
本系列视频介绍了各种 Compose API,可让您快速了解可用 API 以及如何使用它们。
有问题或反馈
请访问我们的常见问题解答页面,了解简短指南,或与我们联系,告诉我们您的想法。