如何在Kotlin与Jetpack Compose LazyList中检测用户是否曾滚动过及滚动是否停止

好问题！我之前在项目里正好碰到过这个需求——默认的isScrollInProgress确实没法区分「用户从未滚动过」和「滚动后停止」这两种状态，不过我们可以通过自定义状态跟踪 + 利用LazyList的现有API来解决这个问题，下面分享几种实用的实现方式：

核心思路 #

我们需要额外维护一个布尔状态hasScrolled，用来标记用户是否已经触发过至少一次滚动操作。之后结合LazyListState.isScrollInProgress，就能精准区分三种状态：

• 初始未滚动：!hasScrolled && !isScrollInProgress
• 正在滚动：isScrollInProgress
• 滚动停止：hasScrolled && !isScrollInProgress

具体实现方案 #

方案1：通过交互源（InteractionSource）监听滚动开始事件 #

这种方式最精准，因为它直接监听用户的滚动触发行为（比如手指按下开始拖动），只要用户尝试滚动，就标记hasScrolled为true：

@Composable
fun ScrollAwareLazyList() {
    val lazyListState = rememberLazyListState()
    var hasScrolled by remember { mutableStateOf(false) }
    var scrollStatus by remember { mutableStateOf("初始未滚动") }

    // 监听滚动交互事件
    LaunchedEffect(lazyListState.interactionSource) {
        lazyListState.interactionSource.interactions.collect { interaction ->
            when (interaction) {
                is ScrollInteraction.Start -> {
                    // 用户开始滚动，标记状态
                    hasScrolled = true
                }
                is ScrollInteraction.Stop -> {
                    // 滚动停止时更新状态（仅当用户已滚动过）
                    if (hasScrolled) {
                        scrollStatus = "滚动已停止"
                    }
                }
            }
        }
    }

    // 实时更新滚动状态
    LaunchedEffect(lazyListState.isScrollInProgress, hasScrolled) {
        scrollStatus = when {
            !hasScrolled && !lazyListState.isScrollInProgress -> "初始未滚动"
            lazyListState.isScrollInProgress -> "正在滚动"
            else -> "滚动已停止"
        }
    }

    Column(modifier = Modifier.fillMaxSize()) {
        Text(
            text = "当前状态: $scrollStatus",
            modifier = Modifier.padding(16.dp),
            fontSize = 18.sp
        )
        LazyColumn(
            state = lazyListState,
            modifier = Modifier.weight(1f)
        ) {
            items(50) { index ->
                Text(
                    text = "列表项 #$index",
                    modifier = Modifier
                        .fillMaxWidth()
                        .padding(16.dp),
                    fontSize = 16.sp
                )
            }
        }
    }
}

方案2：通过滚动位置变化标记滚动行为 #

如果不需要监听滚动开始的瞬间，也可以通过监听列表可见项的位置变化来判断用户是否滚动过——只要列表的滚动偏移或可见项索引发生变化，就说明用户进行了滚动：

@Composable
fun PositionBasedScrollDetection() {
    val lazyListState = rememberLazyListState()
    var hasScrolled by remember { mutableStateOf(false) }
    var scrollStatus by remember { mutableStateOf("初始未滚动") }

    // 监听可见项索引变化
    LaunchedEffect(lazyListState) {
        snapshotFlow { lazyListState.firstVisibleItemIndex }
            .distinctUntilChanged() // 避免重复触发
            .collect { index ->
                // 初始索引是0，只要索引变化，说明用户滚动过
                if (index != 0) {
                    hasScrolled = true
                }
            }
    }

    // 同样结合isScrollInProgress判断状态
    LaunchedEffect(lazyListState.isScrollInProgress, hasScrolled) {
        scrollStatus = when {
            !hasScrolled && !lazyListState.isScrollInProgress -> "初始未滚动"
            lazyListState.isScrollInProgress -> "正在滚动"
            else -> "滚动已停止"
        }
    }

    // 后面的LazyColumn实现和方案1一致，这里省略
}

注意事项 #

• 如果列表项数量很少（不足以滚动），hasScrolled会保持false，这符合预期——因为用户确实无法进行滚动操作。
• 使用snapshotFlow时建议加上distinctUntilChanged()，避免状态的频繁更新，优化性能。
• 所有的状态监听都要放在LaunchedEffect中，确保在Compose的生命周期内正确收集流，避免内存泄漏。

总结 #

目前Jetpack Compose的LazyListState并没有直接提供scrollEnded这类状态，但通过自定义状态+现有API的组合，完全可以实现区分「初始未滚动」和「滚动停止」的需求。上面的两种方案可以根据你的具体场景选择：如果需要精准监听用户的滚动触发行为，选方案1；如果只需要判断用户是否滚动过列表，方案2更简单。

内容的提问来源于stack exchange，提问作者jens