Jetpack Compose中BottomSheet滚动行为修改及最大高度限制问题

要实现内容优先滚动、限制弹窗最大高度的需求，可从高度限制和触摸事件优先级反转两方面入手：

一、限制底部弹窗的最大高度 #

直接给弹窗内容添加heightIn(max = ...)修饰符，配合verticalScroll让超出高度的内容可滚动：

• heightIn(max = 400.dp)：根据业务需求设置弹窗的最大高度，超出部分自动进入滚动状态
• verticalScroll(rememberScrollState())：为内容添加滚动能力

二、反转触摸事件优先级（让内容先处理滚动） #

默认情况下ModalBottomSheet会优先拦截触摸事件，我们可以通过自定义NestedScrollConnection来反转这个逻辑：
在弹窗内容的修饰符中添加nestedScroll，在onPreScroll方法中判断内容是否还能滚动：

• 若内容可以上下滚动（未到顶/底），则让内容优先消费滚动事件
• 若内容无法继续滚动，则将事件传递给弹窗，允许其展开/收起

完整代码示例 #

@Composable
fun CustomScrollPriorityBottomSheet() {
    val sheetState = rememberModalBottomSheetState(
        initialValue = ModalBottomSheetValue.PartiallyExpanded,
        skipPartiallyExpanded = false
    )
    val coroutineScope = rememberCoroutineScope()

    ModalBottomSheetLayout(
        sheetState = sheetState,
        sheetContent = {
            Column(
                modifier = Modifier
                    .heightIn(max = 400.dp) // 限制弹窗最大高度
                    .verticalScroll(rememberScrollState())
                    .nestedScroll(remember {
                        object : NestedScrollConnection {
                            override fun onPreScroll(available: Offset, source: NestedScrollSource): Offset {
                                // 判断内容是否可继续滚动
                                val canScrollUp = available.y < 0 && source == NestedScrollSource.Drag
                                val canScrollDown = available.y > 0 && source == NestedScrollSource.Drag
                                
                                return if (canScrollUp || canScrollDown) {
                                    Offset.Zero // 不消耗事件，交给内容处理滚动
                                } else {
                                    available // 内容无法滚动，交给弹窗处理展开/收起
                                }
                            }
                        }
                    })
            ) {
                // 示例长内容
                repeat(20) {
                    Text(
                        text = "弹窗条目 $it",
                        modifier = Modifier.padding(horizontal = 16.dp, vertical = 12.dp),
                        fontSize = 16.sp
                    )
                }
            }
        }
    ) {
        // 主界面内容
        Column(
            modifier = Modifier.fillMaxSize(),
            verticalArrangement = Arrangement.Center,
            horizontalAlignment = Alignment.CenterHorizontally
        ) {
            Button(
                onClick = {
                    coroutineScope.launch { sheetState.show() }
                }
            ) {
                Text("打开自定义底部弹窗")
            }
        }
    }
}

关键逻辑说明 #

1. 高度限制：通过heightIn(max)直接约束弹窗的最大可视高度，内容超出后自动触发滚动
2. 滚动优先级反转：自定义NestedScrollConnection拦截滚动事件，优先让内容消费滚动动作，只有当内容滚动到边界时，才允许弹窗响应触摸事件进行展开/收起操作

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