Jetpack Compose中实现TextField获焦时屏幕自动滚动的方法

核心修改方案 #

• 绑定焦点与滚动逻辑：给TextField添加焦点监听，获焦时触发滚动操作，替代原有点击事件（TextField本身支持获焦，无需额外点击回调）。
• 优化布局适配键盘：给外层滚动容器添加键盘适配内边距，确保键盘弹出时布局有足够空间调整。
• 统一滚动状态管理：确保滚动状态变量能被TextField的焦点回调访问到，避免作用域问题。

修改后的完整代码 #

@Composable
fun ScrollableTextFieldLayout(loadingAlpha: Float) {
    val scrollState = rememberScrollState()
    val focusRequester = remember { FocusRequester() }
    val coroutineScope = rememberCoroutineScope()

    Column(
        modifier = Modifier
            .fillMaxWidth()
            .padding(bottom = 2.dp)
            .alpha(loadingAlpha)
            .background(Color.White)
            .verticalScroll(scrollState)
            .imePadding(), // 关键：添加键盘适配内边距
        horizontalAlignment = Alignment.CenterHorizontally
    ) {
        // 模拟长列表中的其他元素
        repeat(8) {
            Text(
                text = "列表项 $it",
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(16.dp)
            )
        }

        TextField(
            value = "",
            onValueChange = {},
            modifier = Modifier
                .fillMaxHeight()
                .weight(0.75f)
                .focusRequester(focusRequester)
                .onFocusChanged { focusState ->
                    if (focusState.isFocused) {
                        coroutineScope.launch {
                            // 滚动到TextField所在位置，若需精确对齐可使用bringIntoView
                            // focusRequester.bringIntoView()
                            scrollState.animateScrollTo(scrollState.maxValue)
                        }
                    }
                },
            label = { Text("请输入内容") }
        )

        // 底部占位元素
        repeat(5) {
            Text(
                text = "底部内容 $it",
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(16.dp)
            )
        }
    }
}

关键说明 #

• imePadding()：自动添加与键盘高度匹配的底部内边距，保证布局不会被键盘完全遮挡，是adjustResize生效后的重要补充。
• onFocusChanged回调：仅在TextField获焦时触发滚动，逻辑更精准，避免点击空白区域误触发滚动。
• bringIntoView()：如果animateScrollTo无法精准滚动到TextField可见区域，可替换为focusRequester.bringIntoView()，它会自动计算并滚动到组件的最佳可见位置。
• 保持adjustResize配置：确保AndroidManifest.xml中对应Activity的android:windowSoftInputMode="adjustResize"配置不变，这是布局自适应键盘的基础前提。

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