Android Jetpack Compose：如何让TextField获焦且不自动弹出软键盘

要实现TextField保持焦点但默认不弹出软键盘，仅用户手动点击时弹出的需求，核心是阻止系统在焦点自动请求时唤起键盘，同时保留用户交互时的键盘唤起逻辑。你之前用softwareKeyboard?.hide()出现的"先弹再隐"问题，是因为系统默认的键盘唤起逻辑优先级更高，延迟执行的hide操作跟不上。

具体实现步骤： #

• 使用FocusRequester请求焦点，通过WindowInsetsControllerCompat直接控制软键盘显隐，避免事后隐藏的延迟问题
• 监听TextField点击事件，用户手动点击时主动唤起软键盘
• 切换TextField时，重新请求焦点并隐藏键盘

修改后的代码： #

import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Column
import androidx.compose.material.OutlinedTextField
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.focus.FocusRequester
import androidx.compose.ui.focus.focusRequester
import androidx.compose.ui.platform.LocalView
import androidx.compose.ui.text.input.ImeAction
import androidx.compose.ui.text.input.KeyboardOptions
import androidx.compose.ui.text.input.KeyboardActions
import androidx.core.view.WindowInsetsCompat
import androidx.core.view.WindowInsetsControllerCompat

@Composable
fun ScannerTextField() {
    var fieldValue by remember { mutableStateOf("") }
    val focusRequester = remember { FocusRequester() }
    val view = LocalView.current
    val windowInsetsController = remember { WindowInsetsControllerCompat(view.window, view) }
    var showOutlinedTextField1 by remember { mutableStateOf(true) }

    Column {
        if (showOutlinedTextField1) {
            OutlinedTextField(
                label = { Text("TEXT1") },
                value = fieldValue,
                singleLine = true,
                modifier = Modifier
                    .fillMaxWidth()
                    .focusRequester(focusRequester)
                    // 用户点击时主动唤起键盘
                    .clickable {
                        focusRequester.requestFocus()
                        windowInsetsController.show(WindowInsetsCompat.Type.ime())
                    },
                onValueChange = { enteredValue ->
                    fieldValue = enteredValue
                },
                keyboardOptions = KeyboardOptions.Default.copy(
                    imeAction = ImeAction.Done
                ),
                keyboardActions = KeyboardActions(
                    onDone = {
                        fieldValue = ""
                        showOutlinedTextField1 = false
                    }
                ),
                // 自动获焦时隐藏键盘，覆盖系统默认行为
                onFocusChanged = { state ->
                    if (state.isFocused) {
                        windowInsetsController.hide(WindowInsetsCompat.Type.ime())
                    }
                }
            )
        } else {
            OutlinedTextField(
                label = { Text("TEXT2") },
                value = fieldValue,
                singleLine = true,
                modifier = Modifier
                    .fillMaxWidth()
                    .focusRequester(focusRequester)
                    .clickable {
                        focusRequester.requestFocus()
                        windowInsetsController.show(WindowInsetsCompat.Type.ime())
                    },
                onValueChange = { enteredValue ->
                    fieldValue = enteredValue
                },
                keyboardOptions = KeyboardOptions.Default.copy(
                    imeAction = ImeAction.Done
                ),
                keyboardActions = KeyboardActions(
                    onDone = {
                        fieldValue = ""
                        showOutlinedTextField1 = true
                    }
                ),
                onFocusChanged = { state ->
                    if (state.isFocused) {
                        windowInsetsController.hide(WindowInsetsCompat.Type.ime())
                    }
                }
            )
        }
    }

    // 切换TextField时请求焦点并隐藏键盘
    DisposableEffect(showOutlinedTextField1) {
        focusRequester.requestFocus()
        windowInsetsController.hide(WindowInsetsCompat.Type.ime())
        onDispose { }
    }
}

关键逻辑说明： #

• WindowInsetsControllerCompat：直接操作系统窗口的Insets控制器，比LocalSoftwareKeyboardController更可靠，彻底避免"先弹再隐"的视觉闪烁
• clickable修饰符：用户手动点击时，主动请求焦点并唤起键盘，确保只有交互场景才显示键盘
• onFocusChanged回调：自动获焦时（比如切换TextField）立即隐藏键盘，覆盖系统默认的唤起行为
• DisposableEffect：切换TextField时强制设置焦点并隐藏键盘，保证扫码场景下的焦点状态稳定

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