无障碍模式下如何关闭Jetpack Compose对话框？

针对你遇到的Compose对话框在无障碍模式下无法关闭的问题，以下是几种可行的解决方案：

1. 添加无障碍友好的关闭按钮（推荐） #

遵循Android无障碍设计规范，添加明确的关闭按钮，确保屏幕阅读器能识别它。可以将按钮放在对话框右上角，同时设置清晰的无障碍描述：

Dialog(
    properties = DialogProperties(usePlatformDefaultWidth = false),
    onDismissRequest = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) }
) {
    (LocalView.current.parent as DialogWindowProvider).window.apply {
        setDimAmount(0.8f)
        setGravity(Gravity.CENTER_VERTICAL)
    }

    Box(
        modifier = Modifier.fillMaxWidth()
    ) {
        rotator.ContentCellHorizontalRotator(
            selectedContent = selectedItem
        )

        // 右上角关闭按钮
        IconButton(
            onClick = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) },
            modifier = Modifier.align(Alignment.TopEnd)
        ) {
            Icon(
                imageVector = Icons.Default.Close,
                contentDescription = "关闭对话框" // 屏幕阅读器会播报该描述
            )
        }
    }
}

如果不想显示视觉按钮，可以通过Modifier.alpha(0f)隐藏，但保留无障碍属性：

IconButton(
    onClick = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) },
    modifier = Modifier.align(Alignment.TopEnd).alpha(0f)
) {
    Icon(Icons.Default.Close, contentDescription = "关闭对话框")
}

2. 确保返回键能关闭对话框 #

Compose的Dialog默认响应系统返回键，但如果自定义了窗口属性，可手动添加BackHandler确保功能正常：

Dialog(
    properties = DialogProperties(usePlatformDefaultWidth = false),
    onDismissRequest = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) }
) {
    BackHandler {
        eventReceiver.contentEventReceiver.onCellClick?.invoke(null)
    }

    (LocalView.current.parent as DialogWindowProvider).window.apply {
        setDimAmount(0.8f)
        setGravity(Gravity.CENTER_VERTICAL)
    }

    rotator.ContentCellHorizontalRotator(
        selectedContent = selectedItem
    )
}

视障用户可通过键盘或蓝牙遥控器的返回键关闭对话框，屏幕阅读器会同步播报“返回”操作。

3. 实现自定义无障碍手势 #

为对话框添加双指下滑类的自定义手势，同时通过Semantics告知用户操作方式：

Dialog(
    properties = DialogProperties(usePlatformDefaultWidth = false),
    onDismissRequest = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) }
) {
    var gestureTriggered by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                detectGestures(
                    onDrag = { change, dragAmount ->
                        // 检测双指下滑手势
                        if (change.pressedPoints.size >= 2 && dragAmount.y > 50f && !gestureTriggered) {
                            eventReceiver.contentEventReceiver.onCellClick?.invoke(null)
                            gestureTriggered = true
                        }
                    }
                )
            }
            .semantics {
                contentDescription = "双指向下滑动可关闭对话框"
            }
    ) {
        (LocalView.current.parent as DialogWindowProvider).window.apply {
            setDimAmount(0.8f)
            setGravity(Gravity.CENTER_VERTICAL)
        }

        rotator.ContentCellHorizontalRotator(
            selectedContent = selectedItem
        )
    }
}

4. 利用系统无障碍快捷方式 #

Android系统支持长按电源键打开辅助功能菜单，其中包含“返回”选项可关闭对话框。可在对话框初始化时通过Announcer向用户播报该提示：

Dialog(
    properties = DialogProperties(usePlatformDefaultWidth = false),
    onDismissRequest = { eventReceiver.contentEventReceiver.onCellClick?.invoke(null) }
) {
    val announcer = remember { Announcer(LocalContext.current) }
    LaunchedEffect(Unit) {
        announcer.announce("长按电源键打开辅助功能菜单，选择返回可关闭对话框")
    }

    (LocalView.current.parent as DialogWindowProvider).window.apply {
        setDimAmount(0.8f)
        setGravity(Gravity.CENTER_VERTICAL)
    }

    rotator.ContentCellHorizontalRotator(
        selectedContent = selectedItem
    )
}

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