Jetpack Compose中TextField被软键盘遮挡无法自动滚动到可视区域问题咨询

根因分析 #

你遇到的是软键盘弹出时序和焦点逻辑不同步的问题：用户点击TextField时焦点会立刻被标记为已获取，但软键盘弹出是异步过程，此时系统判断TextField是否在可视区域时，IME高度还没更新到布局树中，会认为组件当前可见，不会触发滚动。等软键盘完全弹出后也没有二次校验逻辑，就出现了遮挡问题。而软键盘已弹出的状态下聚焦新的TextField，此时IME高度已经是最终值，判断逻辑正常，所以滚动会正常触发。

解决方案 #

按以下步骤修改即可实现预期效果：

1. 首先修正Activity的窗口配置，你现在同时开启了系统自行调整布局大小和自定义Insets处理，两者冲突会导致时序异常，将软键盘模式改为SOFT_INPUT_ADJUST_NOTHING，完全由自己处理Insets适配。
2. 给可滚动容器添加accompanist提供的bringIntoViewIfChildrenAreFocused修饰符，它会自动监听焦点变化、IME高度变化，自动滚动容器让聚焦的组件进入可视区域。

修改后的完整代码 #

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        WindowCompat.setDecorFitsSystemWindows(window, false)
        // 改为ADJUST_NOTHING，不允许系统自动调整窗口大小
        window.setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_NOTHING)

        setContent {
            ProvideWindowInsets {
                Column(
                    Modifier
                        .statusBarsPadding()
                        .navigationBarsWithImePadding()
                        .verticalScroll(rememberScrollState())
                        // 添加这一行即可实现自动滚动
                        .bringIntoViewIfChildrenAreFocused()
                ) {
                    val focusManager = LocalFocusManager.current
                    (0..20).forEach {
                        var test by remember { mutableStateOf("") }
                        TextField(
                            value = test,
                            onValueChange = { test = it },
                            label = { Text(it.toString()) },
                            keyboardOptions = KeyboardOptions(imeAction = ImeAction.Next),
                            keyboardActions = KeyboardActions(onNext = {
                                focusManager.moveFocus(FocusDirection.Next)
                            })
                        )
                    }
                }
            }
        }
    }
}

备选方案（不使用accompanist扩展） #

如果你不想用accompanist的这个扩展方法，可以自己实现监听逻辑：

• 单独声明滚动状态和协程作用域
• 给每个TextField绑定BringIntoViewRequester
• 在焦点变化时延迟100ms（等待软键盘弹出完成）触发bringIntoView请求

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