Composable中Dialog内focusManager.clearFocus()失效问题

我看到你遇到了Compose Dialog里TextField触发Done键后，无法清除焦点、收起键盘的问题，这在Dialog场景里确实是个容易踩的小坑，咱们一步步来解决它。

问题根源 #

Dialog作为独立的弹窗组件，其焦点管理的上下文和普通屏幕布局略有差异：仅仅调用focusManager.clearFocus()可能无法正确触发键盘收起——因为键盘的显示状态还需要通过LocalSoftwareKeyboardController主动控制；另外，如果Dialog的根容器没有正确配置焦点范围，也会导致焦点无法被正常清除。

修复方案 #

我们需要结合焦点清除和主动隐藏键盘两个操作，同时确保Dialog布局能正确响应焦点变化。这里提供两种可行的解决方式：

方案1：结合LocalSoftwareKeyboardController手动收起键盘

直接获取键盘控制器，在Done回调中同时执行清除焦点和隐藏键盘的操作，这是最直接的解决方式：

@Composable fun showRouteDialog(
    initialName: String,
    initialDescription: String,
    onResult: (String, String) -> Unit,
    onDismiss: () -> Unit,
    create: Boolean = true
) {
    var name by remember { mutableStateOf(initialName) }
    var description by remember { mutableStateOf(initialDescription) }
    var isLoading by remember { mutableStateOf(false) }
    val focusManager = LocalFocusManager.current
    // 添加键盘控制器实例
    val keyboardController = LocalSoftwareKeyboardController.current

    Dialog(onDismissRequest = { }) {
        Column(
            modifier = Modifier
                .background(
                    MaterialTheme.colors.onPrimary,
                    MaterialTheme.shapes.medium
                )
                .padding(16.dp)
                // 给根容器添加焦点能力，确保焦点范围生效
                .focusable()
        ) {
            TextField(
                value = name,
                enabled = !isLoading,
                onValueChange = { if (it.length <= 50) name = it },
                label = { Text(stringResource(R.string.name)) },
                singleLine = true,
                textStyle = TextStyle(
                    color = nodemappBlack,
                    fontSize = 18.textDp,
                    fontFamily = SourceSansPro
                ),
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(top = 8.dp),
                keyboardOptions = KeyboardOptions(
                    imeAction = ImeAction.Done
                ),
                keyboardActions = KeyboardActions(
                    onDone = {
                        // 先清除TextField的焦点
                        focusManager.clearFocus()
                        // 主动通知系统隐藏键盘
                        keyboardController?.hide()
                    }
                )
            )
        }
    }
}

方案2：通过FocusRequester转移焦点

给Dialog的根Column设置FocusRequester，当Done键触发时，让根容器获取焦点，间接移除TextField的焦点：

@Composable fun showRouteDialog(
    initialName: String,
    initialDescription: String,
    onResult: (String, String) -> Unit,
    onDismiss: () -> Unit,
    create: Boolean = true
) {
    var name by remember { mutableStateOf(initialName) }
    var description by remember { mutableStateOf(initialDescription) }
    var isLoading by remember { mutableStateOf(false) }
    val focusManager = LocalFocusManager.current
    // 创建焦点请求器
    val columnFocusRequester = remember { FocusRequester() }

    Dialog(onDismissRequest = { }) {
        Column(
            modifier = Modifier
                .background(
                    MaterialTheme.colors.onPrimary,
                    MaterialTheme.shapes.medium
                )
                .padding(16.dp)
                .focusRequester(columnFocusRequester)
                .focusable()
        ) {
            TextField(
                value = name,
                enabled = !isLoading,
                onValueChange = { if (it.length <= 50) name = it },
                label = { Text(stringResource(R.string.name)) },
                singleLine = true,
                textStyle = TextStyle(
                    color = nodemappBlack,
                    fontSize = 18.textDp,
                    fontFamily = SourceSansPro
                ),
                modifier = Modifier
                    .fillMaxWidth()
                    .padding(top = 8.dp),
                keyboardOptions = KeyboardOptions(
                    imeAction = ImeAction.Done
                ),
                keyboardActions = KeyboardActions(
                    onDone = {
                        // 让根Column获取焦点，间接移除TextField的焦点
                        columnFocusRequester.requestFocus()
                    }
                )
            )
        }
    }
}

为什么原代码不生效？ #

Dialog的焦点作用域和父布局是分离的，focusManager.clearFocus()仅尝试清除当前焦点，但如果没有其他可接收焦点的元素，系统不会自动收起键盘。加上keyboardController?.hide()可以直接通知系统隐藏键盘；而转移焦点的方式则是通过让容器获取焦点，强制TextField失去焦点，两种方式都能解决问题。

你可以优先尝试方案1，它是最直接高效的解决方式。如果需要处理Dialog关闭时的焦点问题，也可以在onDismiss回调中加入同样的清除焦点和隐藏键盘逻辑。

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