flutter-accessibility

Flutter 无障碍功能

将无障碍功能视为需要实现和验证的行为，而不是仅清理标签。

审查流程

在每个目标平台上，识别主要任务、语义朗读顺序、可操作控件、动态播报、焦点转换、文本缩放、对比度、动画，以及键盘或开关访问方式。

规则

• 优先使用内置语义控件，而不是手动添加 Semantics。
• 为自定义交互式组件设置角色、标签、值、状态和操作，同时避免重复子组件语义。
• 保持视觉、语义和键盘焦点顺序一致。
• 允许文本缩放，且不截断文本或隐藏重要操作。
• 满足符合平台要求的目标尺寸，且不要仅依赖颜色传递信息。
• 在减少动态效果和增强对比度偏好下，仍保留功能。
• 播报有意义的异步状态变化，避免造成重复干扰。
• 如果装饰性内容不提供任何信息，请将其排除在语义树之外。

验证

在启用语义的情况下使用 widget 测试，并酌情使用 Flutter 无障碍准则匹配器。此外，还要在受支持的桌面端和 Web 目标平台上，通过 TalkBack 或 VoiceOver 以及键盘导航测试改动后的流程。

参考资料

• 为自定义组件添加 Semantics、合并子树或触发动态语音播报时，请阅读 语义和屏幕阅读器。
• 审查 WCAG AA 对比度、最小触控目标或大号文本缩放适配时，请阅读 目标尺寸和对比度。

来源

• Flutter 无障碍功能
• 无障碍测试