Jetpack Compose中Modifier.selectableGroup()的作用与使用场景咨询

你测试时觉得加不加这个修饰符没区别，是因为它不影响普通用户的视觉/点击交互逻辑，它的核心作用是给无障碍辅助技术（比如屏幕阅读器、键盘导航）提供语义支持，具体来说：

1. 它解决的核心问题 #

• 屏幕阅读器语义分组：没有selectableGroup时，屏幕阅读器会把每个RadioButton当成独立控件，不会提示用户这是一个单选组；加上之后，阅读器会明确告知"这是一组X个选项中的第Y个"，让视障用户清楚当前选项在组内的位置。
• 键盘导航逻辑优化：在支持键盘导航的场景下，进入单选组后，用方向键可以直接在组内切换选项，无需跳出组去选择其他控件，符合无障碍操作规范。
• 符合无障碍设计标准：单选按钮组必须有明确的分组语义，这是无障碍设计的基本要求，selectableGroup就是帮你实现这个语义的修饰符。

2. 结合你的代码分析 #

第一个例子（直接用RadioButton的onClick） #

你写的SelectableGroup和NotSelectable两个Composable，普通用户点击时行为确实没区别——因为选中状态是你自己用mutableStateOf控制的。但无障碍体验天差地别：

• 没加selectableGroup的版本，屏幕阅读器会把两个RadioButton当成独立的单选控件，不会提示用户它们是互斥的一组；
• 加了的版本，阅读器会识别出这是一个单选组，朗读时会补充组内位置信息。

第二个例子（官方推荐的Row+selectable写法） #

这个是官方推荐的正确实现：用Modifier.selectable(role = Role.RadioButton)给整个选项行添加可选中逻辑，同时把RadioButton的onClick设为null（让selectable处理点击，避免重复响应）。这时候selectableGroup的作用是：

• 告诉辅助技术，这些带Role.RadioButton的selectable控件属于同一组，是互斥选择关系；
• 确保键盘导航时，在组内切换选项的逻辑正常工作。

3. 使用时机总结 #

• 当你实现单选按钮组时，无论用哪种写法，都应该给父容器添加selectableGroup，保证无障碍语义完整；
• 尤其当你使用Modifier.selectable(role = Role.RadioButton)来实现可选中行时，selectableGroup是必须的——它是组内控件语义关联的核心；
• 如果只是单独使用RadioButton（不配合selectable），虽然功能正常，但无障碍体验缺失，这时候加selectableGroup能补上关键的分组语义。

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