SuperAPI AI 工具集

flutter-accessibility

编程与开发

查看项目

更新于 10-22 17:15

技能介绍

Flutter Accessibility 是 Flutter 设计工程师技能集中的一个无障碍专项技能,用于审计和改进 Flutter 应用的无障碍体验、包容性交互、本地化安全和 RTL(从右到左)行为。其核心原则是:将阻碍用户完成核心任务的无障碍缺陷视为发布阻断项。

用途 该技能适用于需要在 Flutter 应用交付前进行无障碍审查、或在开发过程中持续保障无障碍质量的场景。它特别关注屏幕阅读器语义、焦点管理、键盘操作、系统字体缩放、对比度、触控目标、错误提示可访问性以及动效偏好等常见无障碍风险点,同时兼顾多语言和双向布局下的界面正确性。

主要能力 审计方面,技能要求先识别核心用户旅程以及各受支持平台相关的辅助模式,然后检查语义标签、值、提示、分组、标题、实时更新和装饰性元素排除是否正确。它要求使用键盘、类切换焦点和可用的屏幕阅读器进行遍历测试,并验证系统文本缩放至支持的最大值时不出现裁剪或隐藏关键操作。此外还需检查对比度、非颜色提示、触控目标尺寸、错误关联、禁用状态清晰度和动效偏好,并测试长翻译、复数化、双向内容、镜像导航和方向性图标的正确性。

实现方面,技能建议优先使用 Flutter 原生语义控件,而非自定义手势表面;有意合并或排除语义以避免重复播报;保持焦点顺序与视觉及任务顺序一致;异步错误和重要状态变化需要播报但不应过度打扰;当布局需要镜像时使用逻辑方向 API(start/end);不应为了迁就脆弱布局而禁用文本缩放;在提供减少动效行为的同时保留必要的反馈。

使用方式 该技能以工作流形式组织:先审计核心旅程和辅助模式,再检查语义与交互细节,最后实施修复并验证报告。对于多领域仪表盘,还需参考相关文档使语义顺序与跨领域视觉优先级一致。技能文本中引用了项目内的参考文档路径(如 references/accessibility-and-localization.md、references/connected-product-workflows.md),这些文档需在具体项目中存在才能使用。

适用场景 适合 Flutter 应用在发布前进行无障碍合规检查、为已有多语言应用补充 RTL 支持、优化屏幕阅读器体验、修复键盘导航问题,以及在设计系统中建立无障碍实现规范。

限制 该技能依赖人工辅助技术验证,自动化检查不能完全替代真实屏幕阅读器和辅助设备的测试。具体安装命令、版本信息和使用前提暂未提供。