Compose中如何避免TextField获焦时弹出系统键盘

要实现TextField可聚焦、可编辑但不弹出系统键盘的需求，可通过以下方案实现：

核心思路 #

借助LocalSoftwareKeyboardController在TextField获得焦点时立即隐藏系统键盘，同时保持readOnly = false和enabled = true，确保组件可聚焦且能响应自定义输入的状态更新。

修改后的代码示例 #

var text by remember { mutableStateOf("") }
val keyboardController = LocalSoftwareKeyboardController.current

Column(
    modifier = Modifier.fillMaxSize(),
    horizontalAlignment = Alignment.CenterHorizontally,
    verticalArrangement = Arrangement.Center
) {
    TextField(
        value = text,
        onValueChange = { newText ->
            if (newText.all { it.isDigit() } && newText.length <= 10) {
                text = newText
            }
        },
        keyboardOptions = KeyboardOptions(
            keyboardType = KeyboardType.Number,
            imeAction = ImeAction.None // 禁用默认IME操作
        ),
        modifier = Modifier
            .fillMaxWidth(0.8f)
            .onFocusChanged { focusState ->
                // 获得焦点时立即隐藏系统键盘
                if (focusState.isFocused) {
                    keyboardController?.hide()
                }
            },
        label = { Text("Enter numbers") },
        enabled = true,
        readOnly = false // 必须保持false，确保可编辑和聚焦
    )

    // 自定义数字输入UI示例
    Row(
        modifier = Modifier.fillMaxWidth().padding(top = 16.dp),
        horizontalArrangement = Arrangement.SpaceEvenly
    ) {
        repeat(10) { digit ->
            Button(onClick = {
                if (text.length < 10) {
                    text += digit.toString()
                }
            }) {
                Text(digit.toString())
            }
        }
    }
}

关键说明 #

• LocalSoftwareKeyboardController：用于控制系统软件键盘的显示状态，在TextField聚焦时调用hide()直接隐藏键盘。
• onFocusChanged回调：监听焦点变化，确保每次TextField获得焦点时都能触发键盘隐藏操作，避免意外弹出。
• 保持readOnly = false：只读状态会让TextField失去焦点能力和编辑权限，必须禁用才能满足需求。
• 自定义输入UI：通过按钮点击等方式直接更新text状态，替代系统键盘的输入逻辑，完全掌控输入行为。

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