如何实现Jetpack Compose TextField默认聚焦但不自动唤起键盘（仿WhatsApp）

要实现类似WhatsApp的交互效果——页面打开时TextField默认获得焦点（显示光标），但仅在用户主动点击时唤起键盘，可通过手动管理焦点状态与键盘显示时机来实现，具体方案如下：

核心实现代码 #

@Composable
fun ChatInputField() {
    val msg = remember { mutableStateOf(TextFieldValue()) }
    val focusRequester = remember { FocusRequester() }
    val focusManager = LocalFocusManager.current
    val keyboardController = LocalSoftwareKeyboardController.current
    val isInitiallyFocused = remember { mutableStateOf(false) }

    // 页面初始化时请求焦点，显示光标但不唤起键盘
    LaunchedEffect(Unit) {
        focusRequester.requestFocus()
        isInitiallyFocused.value = true
    }

    TextField(
        modifier = Modifier
            .fillMaxWidth()
            .focusRequester(focusRequester)
            .onFocusChanged { focusState ->
                // 区分初始化自动获焦与用户点击获焦：仅用户主动点击时唤起键盘
                if (focusState.isFocused && !isInitiallyFocused.value) {
                    keyboardController?.show()
                }
                isInitiallyFocused.value = focusState.isFocused
            },
        value = msg.value,
        onValueChange = { msg.value = it },
        // 禁用系统默认的自动唤起键盘行为
        keyboardOptions = KeyboardOptions(imeAction = ImeAction.Default),
        // 可选：处理输入完成后的焦点与键盘隐藏逻辑
        keyboardActions = KeyboardActions(
            onDone = {
                focusManager.clearFocus()
                keyboardController?.hide()
            }
        )
    )
}

关键逻辑说明 #

• 焦点手动管理：通过FocusRequester在页面初始化时主动请求TextField焦点，确保光标显示。
• 键盘显示控制：利用onFocusChanged监听焦点状态变化，只有当用户主动点击TextField导致焦点触发时，才调用keyboardController?.show()唤起键盘；初始化自动获焦时不触发键盘。
• 系统行为禁用：通过keyboardOptions保持默认配置，避免系统自动唤起键盘的默认行为。

注意事项 #

• 确保使用Compose 1.1.0及以上版本，LocalSoftwareKeyboardController从该版本开始提供。
• 部分Android系统版本可能存在细微行为差异，需在目标设备上测试验证。

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