Jetpack Compose：如何在可滚动非LazyColumn中控制IME输入法键盘

普通垂直滚动Column实现滚动控制IME的方案 #

前置配置

首先确保基础配置到位：

1. Activity的onCreate方法中添加窗口边距适配配置

WindowCompat.setDecorFitsSystemWindows(window, false)

2. 对应Activity在AndroidManifest.xml中配置软输入模式

<activity
    android:name=".YourTargetActivity"
    android:windowSoftInputMode="adjustResize" />

正确的Column实现代码

val scrollState = rememberScrollState()
val imeNestedScrollConnection = rememberImeNestedScrollConnection()
// 手动创建嵌套滚动分发器，用于传递滚动事件给IME控制逻辑
val imeNestedScrollDispatcher = remember { NestedScrollDispatcher() }

Column(
    modifier = Modifier
        .fillMaxHeight()
        .fillMaxWidth()
        // *注意：nestedScroll修饰符必须放在verticalScroll前面*
        .nestedScroll(
            connection = imeNestedScrollConnection,
            dispatcher = imeNestedScrollDispatcher
        )
        .verticalScroll(scrollState)
        .padding(horizontal = 16.dp, vertical = 8.dp),
    horizontalAlignment = Alignment.CenterHorizontally
) {
    // 此处放置你的Column内容
}

原写法失效原因

• 使用Modifier.verticalScroll的普通Column和LazyColumn的嵌套滚动分发逻辑不同，普通滚动默认不会自动将滚动事件传递给IME嵌套滚动连接，需要手动显式传入NestedScrollDispatcher才能完成事件流转
• 修饰符的顺序会影响事件捕获优先级，nestedScroll必须放在verticalScroll前面，才能优先把滚动事件交给IME控制逻辑处理，再响应Column自身的滚动需求

额外注意事项

• 确保使用的accompanist-insets版本不低于0.23.0，更早版本存在普通滚动容器适配缺陷
• 如果布局外层嵌套了Scaffold，需要将Scaffold自带的nestedScroll参数替换为上述的IME嵌套滚动连接，避免Scaffold默认逻辑消费滚动事件导致IME控制失效

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