SuperAPI AI 工具集

superior-accessibility

前端与建站

查看项目

更新于 10-23 16:16

技能介绍

Superior Accessibility 是一个面向界面无障碍评审与实现的技能,目标是保留用户感知、理解、导航和操作变更后界面的能力。其基本原则是优先使用原生语义与可观察行为,而不是依赖大量 ARIA 补丁。

用途与前提:在确定修复方案前,需先明确受影响的用户旅程、交互模型、支持平台和可用的验证工具。除非必须改变不可访问的交互约定,否则应保留原有产品行为。

结构与命名:使用行为与控件匹配的原生元素;为控件提供与可见标签一致或包含可见标签的可访问名称;保持标题顺序、地标、列表、表格和表单关系有意义;信息性图片提供替代文本,装饰性图像排除在无障碍树外;仅当原生 HTML 无法表达必要关系或状态时添加 ARIA,并保持其同步。

键盘与焦点:所有关键操作应无需指针即可到达和操作;保持与阅读及交互顺序一致的逻辑焦点顺序;焦点指示器在其经过的每个表面上都应可见;仅在真实上下文变化(如打开模态框)时移动焦点,并在上下文关闭时恢复;覆盖层应在适当时候限制焦点、可预测地关闭,且不使背景内容保持可交互。

对比度与非颜色提示:当 Python 可用时,对已知纯色 sRGB 颜色可使用以下命令检查对比度:

python scripts/contrast_check.py "#1f2937" "#ffffff"

该脚本路径应相对于所在 SKILL.md 解析。对于渐变、图像、不透明度、滤镜或合成效果,应检查实际渲染结果,两个源十六进制值不一定代表最终对比度。WCAG 2.x 下正常文本至少 4.5:1,大文本至少 3:1;有意义的组件边界和焦点指示器需对照相邻颜色检查;状态和验证信息应将颜色与文本、图标、形状或其他提示配对;不要因文字为次要信息就认为弱化文本可豁免对比度要求。

动态状态:在字段附近暴露验证错误,表单需要时进行汇总;播报重要异步结果但不反复打断用户;保持加载、展开、选中、按下、勾选、当前、无效和禁用等状态在程序上准确;当禁用操作的前提不明显时,应解释前提而非直接禁用。若任务涉及对话框、复合控件、自定义控件、拖放、实时更新、路由变化、虚拟化内容或特定屏幕阅读器行为,应阅读 references/interaction-and-assistive-technology.md。

缩放、动效与触控:在支持的缩放下重排而不丢失信息或操作;保持聚焦输入框在虚拟键盘和固定 UI 之上可见;提供舒适的触控目标和间距;尊重减少动效偏好,避免必须依赖动效才能理解结果。

验证:对变更旅程进行纯键盘导航;用可用平台工具检查可访问名称和状态;测试相关缩放和窄布局;在渲染后颜色上检查对比度。自动化检查是有用的覆盖手段,但不能证明可用性,应同时报告自动化和人工证据。未明确实际测试的浏览器、辅助技术、平台和旅程时,不得声称屏幕阅读器兼容;环境不可用时,尽可能验证语义和无障碍树输出,并明确报告未测试的组合。

适用场景与限制:当无障碍只是更广泛变更集评审中的一个风险领域时,可配合 superior-code-review;空间驱动的重新组合使用 superior-responsive;无障碍约定之外的视觉或交互实现使用 superior-ui。该技能为评审与实现指南,不替代真实环境下的用户测试;具体支持的浏览器、辅助技术组合和验证工具需视实际环境而定,资料未提供固定清单。