SuperAPI AI 工具集

astrofy-accessibility

通用与其它

查看项目

更新于 10-16 03:49

技能介绍

用途:该技能用于审查 Astro 网站的无障碍性,覆盖语义、焦点管理与键盘操作,将自动检查与人工状态复核结合,并以 WCAG 2.2 AA 为参照。

输入:需阅读有代表性的路由、accessibility tree、焦点样式与交互流程。若路径与示例不同,以 .astrofy/config/paths.json 中定义的路径为准。在应用在线文档中的 API 前,应先核对 lockfile 与 node_modules 中安装的版本。

执行方式:将语义、键盘、对比度与可访问名称的检查结合进行,并记录元素、状态与视口。单独的扫描器不能证明完全合规。需测试 landmark、标题与可访问名称,用 Tab 遍历页面并以键盘操作菜单;检查明暗两套主题的对比度与图片替代文本,将扫描器结果与人工复核分开记录。

具体顺序:通过浏览器 accessibility tree 检查 landmark、标题与链接;完成包含菜单和对话框在内的完整键盘遍历并确保焦点可见;用真实配色测量明暗模式对比度;记录路由、控件、状态、视口与已应用的修复;检查 320 CSS px 下的回流与 400% 缩放,包括长内容、重叠元素以及 hydration 后的状态;将扫描器结果、键盘遍历与辅助技术阅读分开,说明哪些内容未被评估。

修改既有实现:重构时保留 label/for 关联与 ID;更改导航或对话框后重新进行键盘遍历。

验证:仅含图标的按钮需要可访问名称;按功能与名称进行的测试应能定位该控件并用键盘操作。问题描述需包含元素、状态与修复方式。报告不得仅凭扫描器宣称完全合规。

命令:astrofy check --category accessibility

实现前应查阅本领域的 API 与规则,验证输出时参考相应校验场景。资料未提供其他安装方式、收费信息或平台细节。