创建一个用于启用贴靠滚动的按钮

您可以显示一个按钮,让用户快速滚动到列表中的特定位置,从而节省时间并提高用户互动度。

版本兼容性

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

依赖项

创建一个用于启用贴靠滚动的按钮

使用以下代码创建一个按钮,用于在包含 10 个项的垂直延迟列表中实现流畅的卡顿滚动:

@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")
    }
}

代码要点

结果

包含有效按钮的垂直滚动列表
图 1. 带有快速滚动按钮的垂直滚动列表。

包含本指南的集合

本指南属于以下精选快速入门集合,这些集合涵盖了更广泛的 Android 开发目标:

借助列表和网格,您的应用可以以视觉上令人愉悦且易于用户使用的形式显示集合。
了解如何使用可组合函数根据 Material Design 设计系统轻松创建美观的界面组件。
本系列视频介绍了各种 Compose API,可让您快速了解可用 API 以及如何使用它们。

有问题或反馈

请访问我们的常见问题解答页面,了解简短指南,或与我们联系,告诉我们您的想法。

Follow best practices, eliminate boilerplate code, and reduce fragmentation

更新于 Nov 9, 2024

API reference packages and classes for Android app developers.

更新于 Feb 10, 2025

Android Studio builds your app using Gradle

更新于 Oct 16, 2024