Jetpack Compose中如何监听Column滚动事件并触发onScroll回调

前置前提 #

你已经完成的配置无需修改：

• 已通过rememberScrollState()创建并持有滚动状态实例
• 已为Column设置Modifier.verticalScroll(scrollState)开启滚动能力

触发onScroll回调的实现方式 #

方案1：滚动位置变化实时触发 #

只要Column滚动偏移发生变化就触发回调，包含用户手动滚动、代码主动调用scrollTo/animateScrollTo的场景：

@Composable
fun ScrollableColumn(onScroll: () -> Unit, content: @Composable ColumnScope.() -> Unit) {
    val scrollState = rememberScrollState()
    
    // 核心：监听滚动偏移的变化，每次偏移更新时执行回调
    LaunchedEffect(scrollState.value) {
        onScroll()
    }

    Column(
        modifier = Modifier
            .fillMaxSize()
            .verticalScroll(scrollState)
    ) {
        content()
    }
}

注意：该方案会在滚动过程中每帧调用一次onScroll，回调触发频率非常高，适合需要实时监听滚动位置的场景。

方案2：仅用户主动滚动时触发 #

过滤代码主动滚动的场景，仅用户拖动、惯性滚动（fling）时触发回调：

LaunchedEffect(scrollState.isScrollInProgress) {
    // 滚动开始时触发一次
    if (scrollState.isScrollInProgress) {
        onScroll()
    }
    // 如果需要滚动结束时也触发，可在else分支加额外逻辑
}

方案3：防抖触发（适合日志上报场景） #

如果你的日志记录不需要高频上报，可添加防抖逻辑，仅在滚动停止后触发一次回调，避免多余的性能消耗：

LaunchedEffect(scrollState) {
    // 将滚动状态转为Flow，添加200ms防抖
    snapshotFlow { scrollState.value }
        .debounce(200)
        .collect { _ ->
            onScroll()
        }
}

可根据业务需求调整防抖时长，单位为毫秒。

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