Android Compose 实现TextField键盘显示隐藏及跨层控制的标准方案

Compose官方标准的键盘控制逻辑核心依赖三个API：

• FocusRequester：绑定指定TextField，控制其焦点获取/释放
• LocalSoftwareKeyboardController：直接控制软键盘的显隐
• FocusManager：全局清除输入焦点

你之前通过LiveData监听状态的实现思路是正确的，只需要补充FocusRequester绑定TextField焦点的逻辑即可完成指定输入框的键盘唤起操作。

可组合函数完整实现 #

@Composable
fun SearchTextField(
    // 外层传入的键盘状态监听，可直接兼容你现有LiveData实现
    shouldShowKeyboard: Boolean,
    // 可选：把控制方法暴露给外层的回调，支持直接调用控制
    onControllerReady: ((show: Boolean) -> Unit)? = null
) {
    // 1. 创建绑定TextField的焦点请求器，用remember缓存实例
    val focusRequester = remember { FocusRequester() }
    // 2. 获取系统键盘控制器
    val keyboardController = LocalSoftwareKeyboardController.current
    val focusManager = LocalFocusManager.current

    // 3. 监听状态自动控制键盘显隐
    LaunchedEffect(shouldShowKeyboard) {
        if (shouldShowKeyboard) {
            // 先请求TextField获取焦点，再弹出键盘
            focusRequester.requestFocus()
            keyboardController?.show()
        } else {
            // 隐藏键盘同时清除焦点
            keyboardController?.hide()
            focusManager.clearFocus()
        }
    }

    // 可选：将控制方法暴露给外层，支持非状态驱动的直接调用
    DisposableEffect(Unit) {
        val controller: (Boolean) -> Unit = { show ->
            if (show) {
                focusRequester.requestFocus()
                keyboardController?.show()
            } else {
                keyboardController?.hide()
                focusManager.clearFocus()
            }
        }
        onControllerReady?.invoke(controller)
        onDispose { }
    }

    TextField(
        // 绑定焦点请求器到目标TextField
        modifier = Modifier.focusRequester(focusRequester),
        keyboardOptions = KeyboardOptions.Default.copy(
            imeAction = ImeAction.Search,
        ),
        keyboardActions = KeyboardActions(
            onSearch = {
                focusManager.clearFocus()
                keyboardController?.hide()
            }
        )
    )
}

Fragment 层调用实现 #

方案1：状态驱动（兼容你现有LiveData实现） #

// ViewModel中定义状态
val shouldShowSearchKeyBoard = MutableLiveData<Boolean>()

// Fragment中初始化Compose
setContent {
    val shouldShow by shouldShowSearchKeyBoard.observeAsState(false)
    SearchTextField(shouldShowKeyboard = shouldShow)
}

// 外部直接修改状态即可控制键盘
fun hideKeyboard() {
    shouldShowSearchKeyBoard.postValue(false)
}

fun showKeyboard() {
    shouldShowSearchKeyBoard.postValue(true)
}

方案2：直接获取控制回调 #

// Fragment中定义全局控制器变量
private var keyboardController: ((Boolean) -> Unit)? = null

// 初始化Compose时拿到控制器
setContent {
    SearchTextField(
        shouldShowKeyboard = false,
        onControllerReady = { controller ->
            keyboardController = controller
        }
    )
}

// 直接调用方法控制键盘
fun hideKeyboard() {
    keyboardController?.invoke(false)
}

fun showKeyboard() {
    keyboardController?.invoke(true)
}

注意事项 #

• FocusRequester 必须通过Modifier.focusRequester()绑定到目标TextField，才能保证键盘弹出时输入焦点落在对应输入框上
• 唤起键盘必须先调用focusRequester.requestFocus()请求焦点，再调用keyboardController?.show()，否则可能出现键盘弹出但输入框无焦点的异常
• LocalSoftwareKeyboardController是Compose 1.2.0及以上版本的稳定API，废弃的LocalTextInputService请勿继续使用
• 如果需要实现点击Compose内容区域外部隐藏键盘，可给Compose根布局添加pointerInput修饰符，监听点击事件时触发隐藏逻辑即可

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