可滚动列表可以帮助管理数据集、创建响应式设计和促进导航。您可以使用有限滚动列表在应用中显示较小的项目集合。要避免在较大的数据集或长度未知的列表中出现性能问题,请参阅 使用列表和分页延迟加载数据。
版本兼容性
此实现要求您的项目 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)) } } }
关于代码的关键点
- 使用
Column
修饰符和verticalScroll
修饰符以及rememberScrollState
函数设置Column
的滚动行为。 - 要创建水平滚动列表,请使用
Row
和horizontalScroll
修饰符。
结果

包含本指南的收藏集
本指南是这些精选的快速指南集合的一部分,涵盖更广泛的 Android 开发目标

显示列表或网格
列表和网格允许您的应用以用户易于理解的直观形式显示集合。

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

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