如何在Jetpack Compose中彻底禁用IME软键盘

核心方案概述 #

结合Manifest配置、Compose焦点控制和ViewModel状态管理，完全匹配你的需求：

1. 彻底隐藏IME软键盘 #

• 保留原有Manifest配置：android:windowSoftInputMode="stateAlwaysHidden|adjustResize"，从系统层面阻止软键盘默认弹出。
• 在TextField中配合LocalSoftwareKeyboardController主动隐藏软键盘，避免任何场景下的弹出触发。

2. 强制TextField始终保持焦点 #

• 使用FocusRequester控制焦点，确保输入框不会丢失焦点：
  1. 创建全局焦点请求器：val focusRequester = remember { FocusRequester() }
  2. 初始化时通过LaunchedEffect主动请求焦点
  3. 在onFocusChanged回调中，若焦点丢失则立即重新请求

3. 提交文本至ViewModel并清空输入框 #

• 用mutableStateOf绑定输入框文本，提交后清空并重新聚焦
• ViewModel使用mutableStateListOf存储文本列表，实现Compose自动UI更新（替代原RecyclerView+Adapter）

完整可运行代码示例 #

@Composable
fun InputScreen(viewModel: InputViewModel) {
    val focusRequester = remember { FocusRequester() }
    var inputText by remember { mutableStateOf("") }
    val keyboardController = LocalSoftwareKeyboardController.current
    val textList = viewModel.textList

    // 初始化时请求焦点并隐藏软键盘
    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
        keyboardController?.hide()
    }

    Column(modifier = Modifier.fillMaxSize()) {
        TextField(
            value = inputText,
            onValueChange = { inputText = it },
            modifier = Modifier
                .fillMaxWidth()
                .focusRequester(focusRequester)
                .onFocusChanged { focusState ->
                    // 聚焦时隐藏软键盘，失焦时重新请求焦点
                    if (focusState.isFocused) {
                        keyboardController?.hide()
                    } else {
                        focusRequester.requestFocus()
                    }
                },
            keyboardOptions = KeyboardOptions.Default.copy(imeAction = ImeAction.Done),
            keyboardActions = KeyboardActions(
                onDone = {
                    // 非空文本才提交
                    if (inputText.isNotBlank()) {
                        viewModel.addTextToList(inputText)
                        inputText = ""
                        // 清空后重新聚焦并隐藏键盘
                        focusRequester.requestFocus()
                        keyboardController?.hide()
                    }
                }
            ),
            singleLine = true
        )

        // 替代RecyclerView的文本列表展示
        LazyColumn(modifier = Modifier.fillMaxSize()) {
            items(textList) { text ->
                Text(text = text, modifier = Modifier.padding(horizontal = 16.dp, vertical = 8.dp))
            }
        }
    }
}

class InputViewModel : ViewModel() {
    // 使用mutableStateListOf实现自动UI更新
    val textList = mutableStateListOf<String>()

    fun addTextToList(text: String) {
        textList.add(text)
    }
}

关键注意事项 #

• 不要使用readOnly = true，这会阻止物理键盘输入，不符合你的需求
• mutableStateListOf是Compose响应式列表，添加元素后LazyColumn会自动重组，无需手动刷新
• 物理键盘按回车触发onDone回调，完成文本提交流程

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