2023年Jetpack Compose解决软键盘遮挡页面内容问题

一、基础配置（必须步骤） #

1. 修改AndroidManifest.xml
   在目标Activity节点中添加：

   android:windowSoftInputMode="adjustResize|stateHidden"
   

   adjustResize确保窗口随软键盘弹出自动调整大小，stateHidden设置软键盘默认不显示。

2. 配置Activity系统窗口适配
   在MainActivity的onCreate方法中添加以下代码：

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       WindowCompat.setDecorFitsSystemWindows(window, false)
       setContent {
           // 你的Compose主题及根布局内容
       }
   }
   

   这一步让Compose完全接管系统窗口Insets的处理，避免与原生布局计算逻辑冲突。

二、Compose布局调整 #

长表单需使用可滚动容器，并适配软键盘Insets，确保内容始终处于可见区域：

@Composable
fun SomePage(...) {
    val windowInsets = WindowInsets.systemBars
        .only(WindowInsetsSides.Vertical + WindowInsetsSides.Bottom)
    val scrollState = rememberScrollState()

    Column(
        modifier = Modifier
            .fillMaxSize()
            .verticalScroll(scrollState)
            .windowInsetsPadding(windowInsets) // 适配系统栏与软键盘占位空间
            .padding(horizontal = 16.dp)
    ) {
        Text(
            text = "Some Form",
            style = MaterialTheme.typography.titleLarge
        )

        Spacer(modifier = Modifier.height(20.dp))

        // 示例：12个输入框
        repeat(12) {
            OutlinedTextField(
                value = "", // 替换为你的状态变量
                onValueChange = {}, // 替换为你的状态更新逻辑
                label = { Text("Field ${it+1}") },
                modifier = Modifier.fillMaxWidth()
            )
            Spacer(modifier = Modifier.height(12.dp))
        }

        Button(
            onClick = {
                // 点击按钮时关闭软键盘
                LocalSoftwareKeyboardController.current?.hide()
                // 你的其他点击逻辑
            },
            modifier = Modifier.fillMaxWidth()
        ) {
            Text(
                text = "Next",
                textAlign = TextAlign.Center
            )
        }

        // 底部留白，避免按钮被软键盘完全遮挡
        Spacer(modifier = Modifier.height(20.dp))
    }
}

三、关键说明 #

• 可滚动容器：通过verticalScroll修饰符让Column支持滚动，确保长表单可上下滑动查看全部内容。
• Insets适配：windowInsetsPadding自动计算系统栏、软键盘的占位空间，让布局内容始终处于可见区域。
• 软键盘控制：借助LocalSoftwareKeyboardController可直接控制软键盘显示/隐藏，在按钮点击时调用hide()即可关闭。

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