Jetpack Compose：横屏模式下如何实现键盘全屏显示

回答 #

1. 利用TextField的imeOptions参数控制 #

在Jetpack Compose中，对应传统EditText的imeOptions配置，可通过TextField（或OutlinedTextField）的imeOptions参数管理键盘全屏行为：

• 默认状态下，横屏时软键盘自动全屏，无需额外配置，只需保持imeOptions为默认值即可：

var text by remember { mutableStateOf("") }

TextField(
    value = text,
    onValueChange = { text = it },
    label = { Text("input something") },
    imeOptions = ImeOptions.Default,
    modifier = Modifier
        .fillMaxWidth()
        .padding(top = 5.dp, bottom = 25.dp)
)

2. 修复布局适配问题（解决输入框遮挡） #

如果输入框仍被遮挡，核心问题不在键盘全屏状态，而是布局未适配键盘弹出，需调整以下两点：

• 修正Activity的windowSoftInputMode配置：

<activity
    android:name=".YourActivity"
    android:windowSoftInputMode="adjustResize">
    <!-- 其他配置 -->
</activity>

adjustResize会让Activity布局随键盘弹出重新计算尺寸，适配Compose的自适应布局逻辑。

• 优化Compose布局结构：避免使用固定高度的不可滚动容器，可给根布局添加滚动能力：

Column(
    modifier = Modifier
        .fillMaxSize()
        .verticalScroll(rememberScrollState())
) {
    // 其他布局元素
    TextField(/* 你的输入框配置 */)
}

3. 禁用全屏键盘（可选） #

如果需要反向实现禁用横屏全屏键盘（对应传统flagNoFullscreen效果），可在imeOptions中添加对应标记：

TextField(
    value = text,
    onValueChange = { text = it },
    label = { Text("input something") },
    imeOptions = ImeOptions.Default.copy(
        imeMask = ImeOptions.Default.imeMask or ImeFlag.NoFullscreen
    ),
    modifier = Modifier
        .fillMaxWidth()
        .padding(top = 5.dp, bottom = 25.dp)
)

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