Android Jetpack Compose中聚焦TextField时隐藏系统键盘并使用自定义键盘

你之前用getWindow().setSoftInputMode(...)无效的核心原因是：Compose的TextField在获得焦点时会主动向系统请求显示软键盘，覆盖了Window层面的设置。以下是适配Compose生态的解决方案：

核心实现步骤 #

1. 用Compose原生API控制系统键盘 #

通过LocalSoftwareKeyboardController可以直接控制系统键盘的显示/隐藏，这是官方推荐的适配方式，比直接操作Window更贴合Compose的生命周期。

2. 监听TextField焦点状态 #

结合FocusRequester和onFocusChanged修饰符，在TextField获焦时隐藏系统键盘并显示自定义键盘，失焦时隐藏自定义键盘。

3. 配置TextField阻止系统键盘自动弹出 #

通过keyboardOptions和keyboardActions进一步避免系统键盘被触发。

完整代码示例 #

@Composable
fun CustomKeyboardTextField() {
    val focusRequester = remember { FocusRequester() }
    val keyboardController = LocalSoftwareKeyboardController.current
    var inputText by remember { mutableStateOf("") }
    var isCustomKeyboardVisible by remember { mutableStateOf(false) }

    Column(
        modifier = Modifier.fillMaxSize(),
        verticalArrangement = Arrangement.Center
    ) {
        // 带自定义键盘的TextField
        TextField(
            value = inputText,
            onValueChange = { inputText = it },
            modifier = Modifier
                .fillMaxWidth()
                .padding(horizontal = 16.dp)
                .focusRequester(focusRequester)
                .onFocusChanged { focusState ->
                    if (focusState.isFocused) {
                        // 隐藏系统键盘
                        keyboardController?.hide()
                        // 显示自定义键盘
                        isCustomKeyboardVisible = true
                    } else {
                        // 失焦时隐藏自定义键盘
                        isCustomKeyboardVisible = false
                    }
                },
            // 配置键盘选项，避免触发系统键盘
            keyboardOptions = KeyboardOptions(
                imeAction = ImeAction.None,
                keyboardType = KeyboardType.Text
            ),
            keyboardActions = KeyboardActions(
                onAny = { keyboardController?.hide() }
            ),
            placeholder = { Text("点击输入") }
        )

        // 自定义键盘组件（示例实现）
        if (isCustomKeyboardVisible) {
            Column(
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(top = 16.dp)
            ) {
                // 第一行按键
                Row(
                    modifier = Modifier.fillMaxWidth(),
                    horizontalArrangement = Arrangement.SpaceEvenly
                ) {
                    listOf("1", "2", "3", "4", "5").forEach { key ->
                        KeyButton(key) { inputText += key }
                    }
                }
                // 第二行按键
                Row(
                    modifier = Modifier.fillMaxWidth(),
                    horizontalArrangement = Arrangement.SpaceEvenly,
                    verticalAlignment = Alignment.CenterVertically
                ) {
                    listOf("6", "7", "8", "9", "0").forEach { key ->
                        KeyButton(key) { inputText += key }
                    }
                }
                // 删除键
                Row(
                    modifier = Modifier.fillMaxWidth(),
                    horizontalArrangement = Arrangement.Center
                ) {
                    Button(
                        onClick = {
                            if (inputText.isNotEmpty()) {
                                inputText = inputText.substring(0, inputText.length - 1)
                            }
                        },
                        modifier = Modifier.padding(top = 8.dp)
                    ) {
                        Text("删除")
                    }
                }
            }
        }
    }
}

// 自定义按键组件
@Composable
private fun KeyButton(text: String, onClick: () -> Unit) {
    Button(
        onClick = onClick,
        modifier = Modifier.padding(4.dp),
        contentPadding = PaddingValues(horizontal = 16.dp, vertical = 12.dp)
    ) {
        Text(text, fontSize = 18.sp)
    }
}

额外优化建议 #

如果需要更彻底地阻止系统键盘弹出，可以在AndroidManifest.xml中对应Activity的标签里添加：

android:windowSoftInputMode="stateAlwaysHidden"

但仍需配合Compose内的焦点监听逻辑，因为TextField的内部逻辑可能仍会触发键盘显示。

内容的提问来源于stack exchange，提问作者I'm AI