mcpField
F
flutter-accessibility

flutter-accessibility

github.com/musabekisakov-imj设计与 UI441 次安装14 周前更新
代码仓库

关于 flutter-accessibility

flutter-accessibility 是一项用于审查和落实 Flutter 项目无障碍要求的技能。它涵盖辅助导航、文字缩放、对比度、本地化和动态效果,并要求报告区分自动检查与人工验证。

主要功能

  1. 01审查语义信息与辅助导航
  2. 02测试文字缩放和对比度
  3. 03检查本地化与 RTL 布局
  4. 04优先使用原生语义控件
  5. 05报告验证结果与缺口

适用场景

  1. 01发布前审查 Flutter 应用
  2. 02检查键盘与屏幕阅读器操作流程
  3. 03测试翻译及双向界面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/musabekisakov-imj/flutter-design-engineer --skill flutter-accessibility

安装后在 Claude Code 中输入/flutter-accessibility确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
accessibility-and-localization.md
connected-product-workflows.md

详细介绍

Flutter 无障碍功能

阻碍核心任务的无障碍问题应视为发布阻断项。

审查

  1. 确定核心用户旅程,以及受支持平台上相关的辅助模式。
  2. 检查语义、标签、值、提示、分组、标题、实时更新和装饰性内容的排除情况。
  3. 在可用情况下,使用键盘、类似开关的焦点导航和屏幕阅读器进行遍历。
  4. 将系统文字缩放测试至受支持的最大值,确保内容不会被裁切,关键操作也不会被隐藏。
  5. 验证对比度、非颜色提示、触控目标、错误关联、禁用状态的清晰度,以及对动态效果偏好的支持。
  6. 测试较长的译文、复数形式、双向内容、镜像导航和方向性图标是否正确。
  7. 阅读 references/accessibility-and-localization.md 以及项目中已有的相关平台指南。 对于多领域仪表板,阅读 references/connected-product-workflows.md,并确保语义顺序与跨领域的视觉优先级一致。

实施

  • 优先使用 Flutter 原生语义控件,而非自定义手势界面。
  • 有意识地合并或排除语义,避免重复播报。
  • 让焦点顺序与视觉顺序和任务顺序保持一致。
  • 播报异步错误和重要状态变更,但避免过多提示。
  • 布局需要镜像时,使用逻辑方向 API(start/end)。
  • 不要为了适配脆弱的布局而禁用文字缩放。
  • 提供减少动态效果的行为,同时保留必要的反馈。

验证与报告

说明测试过的工具、平台、文字缩放级别、语言区域、阅读方向、主题和用户旅程。区分自动化检查与辅助技术的手动验证,并指出尚未覆盖的部分。

评论

支持 Markdown