Jetpack Compose中不使用TextField，通过LocalSoftwareKeyboardController控制软键盘显隐

核心思路 #

Compose中软键盘的输入事件依赖输入组件（如TextField）接收，因此合理方案是用不可见的BasicTextField处理输入逻辑，同时让自定义组件管理焦点状态联动键盘显隐——这并非取巧，而是利用Compose焦点系统与输入组件原生能力的标准实现方式。

实现步骤 #

1. 初始化核心对象

在Composable函数内声明所需的状态与控制器：

// 管理焦点请求与状态监听
val focusRequester = remember { FocusRequester() }
// 控制软键盘的显示与隐藏
val keyboardController = LocalSoftwareKeyboardController.current
// 存储键盘输入内容（已实现自定义组件渲染）
val inputText = remember { mutableStateOf("") }

2. 为自定义组件绑定焦点逻辑

给自定义组件添加焦点修饰符，监听焦点变化触发键盘操作：

CustomDisplayComponent(
    text = inputText.value,
    modifier = Modifier
        .focusRequester(focusRequester)
        .onFocusChanged { focusState ->
            when {
                focusState.isFocused -> {
                    // 组件获焦时显示软键盘
                    keyboardController?.show()
                }
                !focusState.isFocused && !focusState.hasFocus -> {
                    // 组件失焦时隐藏软键盘
                    keyboardController?.hide()
                }
            }
        }
        // 可选：添加点击组件请求焦点的逻辑
        .clickable {
            focusRequester.requestFocus()
        }
)

3. 添加不可见的输入处理组件

用BasicTextField承接键盘输入，配置KeyboardOptions和KeyboardActions，并设置为不可见：

BasicTextField(
    value = inputText.value,
    onValueChange = { inputText.value = it },
    modifier = Modifier
        .size(0.dp) // 隐藏组件，不占用布局空间
        .focusRequester(focusRequester), // 与自定义组件共享焦点请求器，同步焦点状态
    keyboardOptions = KeyboardOptions(
        // 配置键盘类型，例如数字键盘
        keyboardType = KeyboardType.Number,
        // 配置回车键行为
        imeAction = ImeAction.Done
    ),
    keyboardActions = KeyboardActions(
        // 处理回车键自定义逻辑
        onDone = {
            keyboardController?.hide()
            focusRequester.freeFocus()
        }
    ),
    // 隐藏光标，避免视觉干扰
    cursorBrush = SolidColor(Color.Transparent)
)

关键说明 #

• 焦点同步：自定义组件与BasicTextField共享FocusRequester，确保焦点状态一致，键盘输入能正确更新inputText。
• 键盘控制：通过onFocusChanged监听焦点状态，调用SoftwareKeyboardController的show()/hide()实现键盘显隐。
• 输入配置：KeyboardOptions定义键盘类型、回车键行为，KeyboardActions处理回车键等按键的自定义逻辑。

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