创建一个按钮以启用吸附式滚动

你可以显示一个按钮,让用户可以将列表吸附式滚动到特定点,从而节省时间并提高用户参与度。

版本兼容性

此实现要求你的项目 minSDK 设为 API 级别 21 或更高。

依赖项

创建一个按钮以启用吸附式滚动

使用以下代码在包含 10 个项的纵向 Lazy List 中创建用于平滑吸附式滚动的按钮

@Composable
fun MessageList(modifier: Modifier = Modifier) {
    val listState = rememberLazyListState()
    val coroutineScope = rememberCoroutineScope()

    LazyColumn(state = listState, modifier = Modifier.height(120.dp)) {
        items(10) { index ->
            Text(
                modifier = Modifier.height(40.dp),
                text = "Item $index"
            )
        }
    }

    Button(onClick = {
        coroutineScope.launch {
            listState.animateScrollToItem(index = 0)
        }
    }) {
        Text(text = "Go top")
    }
}

关于代码的要点

结果

A vertically scrolling list with an active button
图 1. 带有吸附式滚动按钮的纵向滚动列表。

包含本指南的合集

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

列表和网格让你的应用可以以视觉效果好、易于用户消化的形式显示集合。
了解可组合函数如何让你轻松创建基于 Material Design 设计系统的精美界面组件。
本系列视频介绍了各种 Compose API,快速展示了可用的 API 及其使用方法。

有疑问或反馈

前往我们的常见问题页面,了解快速指南,或联系我们并告诉我们你的想法。