Compose AlertDialog中TextField关闭键盘后无法再次唤起问题求助

问题现象 #

在AlertDialog中嵌入TextField后出现以下异常：

• 打开Dialog时键盘默认关闭，首次点击TextField可正常唤起键盘
• 点击Done按钮或设备导航栏的向下箭头关闭键盘后，TextField仍保持聚焦状态
• 此时再次点击TextField，无法重新唤起键盘

问题代码 #

AlertDialog(
            modifier = modifier.padding(horizontal = 16.dp),
            containerColor = Color.White,
            onDismissRequest = { },
            properties = DialogProperties(usePlatformDefaultWidth = false),
            text = {
                Column(
        modifier = modifier
            .padding(8.dp),
        horizontalAlignment = Alignment.CenterHorizontally,
        verticalArrangement = Arrangement.spacedBy(8.dp)
    ) {
        TitleText(
            text = stringResource(R.string.now_schedule),
            color = MaterialTheme.colorScheme.onSurface
        )
        LightContentText(
            text = stringResource(R.string.you_can_search_course_apply_course_and_find_scholarship_for_abroad_studies),
            color = MaterialTheme.colorScheme.outline
        )
        CoralBasicTextField(
            modifier = modifier
                .fillMaxWidth()
                .height(maxHeight.div(3)),
            value = descriptionValue,
            updateTextValue = {
                setDescriptionValue(it)
            },
            keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done),
            contentAlignment = Alignment.TopStart,
            textStyle = MaterialTheme.typography.bodyLarge,
            placeholder = stringResource(R.string.description)
        )
    }
            },
            dismissButton = {},
            confirmButton = {
                Row(
                    modifier = modifier
                        .fillMaxWidth()
                        .padding(horizontal = 16.dp),
                    horizontalArrangement = Arrangement.SpaceEvenly,
                    verticalAlignment = Alignment.CenterVertically
                ) {
                    LightContentText(
                        modifier = modifier
                            .weight(1f)
                            .clickable { onShowDoneDialog(false, false) },
                        text = stringResource(R.string.cancel),
                        style = LocalTextStyle.current.copy(
                            color = MaterialTheme.colorScheme.primary,
                            fontSize = 14.sp
                        )
                    )
                    CoralButton(
                        modifier = modifier.weight(1f),
                        onClick = {
                            onShowDoneDialog(false, true)
                        }) {
                        MediumContentText(
                            text = stringResource(R.string.save),
                            style = MaterialTheme.typography.bodyMedium
                        )
                    }
                }
            }
        )

问题原因 #

TextField在键盘关闭后仍持有焦点，但系统输入法状态未与焦点状态同步，导致再次点击时无法触发键盘唤起逻辑。

解决方案 #

通过手动管理焦点和键盘状态，同步焦点与输入法的状态：

1. 引入FocusRequester、LocalSoftwareKeyboardController和LocalFocusManager控制焦点和键盘
2. 点击TextField时主动请求焦点并唤起键盘
3. 监听Done按钮事件，关闭键盘的同时清除焦点
4. 监听输入法窗口可见性，当键盘隐藏时自动清除焦点（覆盖导航栏箭头关闭键盘的场景）

修改后的完整代码 #

@Composable
fun FixedScheduleDialog(
    modifier: Modifier = Modifier,
    descriptionValue: String,
    setDescriptionValue: (String) -> Unit,
    onShowDoneDialog: (Boolean, Boolean) -> Unit,
    maxHeight: Dp
) {
    val focusRequester = remember { FocusRequester() }
    val keyboardController = LocalSoftwareKeyboardController.current
    val focusManager = LocalFocusManager.current
    val imeInsets = LocalWindowInsets.current.ime

    // 监听键盘隐藏事件，自动清除焦点
    LaunchedEffect(imeInsets.isVisible) {
        if (!imeInsets.isVisible) {
            focusManager.clearFocus()
        }
    }

    AlertDialog(
        modifier = modifier.padding(horizontal = 16.dp),
        containerColor = Color.White,
        onDismissRequest = { },
        properties = DialogProperties(usePlatformDefaultWidth = false),
        text = {
            Column(
                modifier = modifier.padding(8.dp),
                horizontalAlignment = Alignment.CenterHorizontally,
                verticalArrangement = Arrangement.spacedBy(8.dp)
            ) {
                TitleText(
                    text = stringResource(R.string.now_schedule),
                    color = MaterialTheme.colorScheme.onSurface
                )
                LightContentText(
                    text = stringResource(R.string.you_can_search_course_apply_course_and_find_scholarship_for_abroad_studies),
                    color = MaterialTheme.colorScheme.outline
                )
                CoralBasicTextField(
                    modifier = modifier
                        .fillMaxWidth()
                        .height(maxHeight.div(3))
                        .focusRequester(focusRequester)
                        .clickable {
                            // 点击时主动请求焦点并唤起键盘
                            focusRequester.requestFocus()
                            keyboardController?.show()
                        },
                    value = descriptionValue,
                    updateTextValue = setDescriptionValue,
                    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Done),
                    keyboardActions = KeyboardActions(
                        onDone = {
                            // Done按钮点击后关闭键盘并清除焦点
                            keyboardController?.hide()
                            focusManager.clearFocus()
                        }
                    ),
                    contentAlignment = Alignment.TopStart,
                    textStyle = MaterialTheme.typography.bodyLarge,
                    placeholder = stringResource(R.string.description)
                )
            }
        },
        dismissButton = {},
        confirmButton = {
            Row(
                modifier = modifier
                    .fillMaxWidth()
                    .padding(horizontal = 16.dp),
                horizontalArrangement = Arrangement.SpaceEvenly,
                verticalAlignment = Alignment.CenterVertically
            ) {
                LightContentText(
                    modifier = modifier
                        .weight(1f)
                        .clickable { onShowDoneDialog(false, false) },
                    text = stringResource(R.string.cancel),
                    style = LocalTextStyle.current.copy(
                        color = MaterialTheme.colorScheme.primary,
                        fontSize = 14.sp
                    )
                )
                CoralButton(
                    modifier = modifier.weight(1f),
                    onClick = { onShowDoneDialog(false, true) }
                ) {
                    MediumContentText(
                        text = stringResource(R.string.save),
                        style = MaterialTheme.typography.bodyMedium
                    )
                }
            }
        }
    )
}

说明 #

• FocusRequester用于手动请求TextField的焦点，确保点击时能触发键盘唤起
• KeyboardActions处理Done按钮事件，同步关闭键盘和清除焦点
• LaunchedEffect监听输入法窗口状态，覆盖通过导航栏箭头关闭键盘的场景，确保焦点被及时清除

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