SuperAPI AI 工具集

accessibility

前端与建站

查看项目

更新于 10-16 05:47

技能介绍

用途:帮助开发者把应用做得可访问,符合 WCAG 指南,实现 ARIA 模式,支持屏幕阅读器与键盘操作。资料把无障碍视为与性能、安全同级的质量属性,并指出从一开始使用正确 HTML 即可免费获得约 80% 的无障碍效果。

分工原则:由你设定标准,AI 负责实现,你负责测试。例如你决定“应用必须可键盘导航”,AI 实现焦点管理、Tab 顺序与键盘处理;你决定“所有图片需要描述”,AI 为每张图片加 alt 文本。

优先级:Tier 1 覆盖约 80% 问题,包括语义化 HTML、键盘导航、颜色对比度、表单标签、图片 alt 文本。Tier 2 在产品上线后加入:焦点管理、错误消息、跳转导航、减少动效。Tier 3 在找到产品市场契合后打磨:完整 ARIA 模式、屏幕阅读器测试、色盲适配。

主要能力与用法:语义化 HTML 方面,用 button 表示动作、a 表示导航,使用 nav、main、aside、header、footer、article、section,标题按 h1 到 h6 顺序,label 关联每个输入,列表用 ul/ol,表格用 th,模态用 dialog。键盘导航方面,所有交互元素可用 Tab 到达、用 Enter 或 Space 激活,Tab 顺序符合视觉阅读顺序,焦点状态清晰可见,模态内锁定焦点并在关闭时返回触发元素,首个可聚焦元素为“跳到主内容”链接。对比度方面,正文 4.5:1,大号文本(18px+ 或 14px+ 粗体)3:1,UI 组件(边框、图标)3:1,不能仅靠颜色传达信息。表单与图片方面,每个输入需有可见 label 并通过 for="id" 关联,占位符不是标签,必填项加视觉提示与 aria-required="true",个人数据加 autocomplete;有意义的图片加描述性 alt(最多 125 字符),装饰性图片用 alt="",图表需附近文本或 aria-describedby。Tier 2 还包括:模态打开时焦点移入首个交互元素,关闭时返回触发按钮;错误消息通过 aria-describedby 关联,无效字段加 aria-invalid="true",动态内容用 aria-live="polite" 或 assertive 播报;用 @media (prefers-reduced-motion: reduce) { * { animation: none !important; } } 尊重减少动效偏好,关闭自动播放,过渡控制在 200ms 内或移除。

测试:5 分钟快速测试为收起鼠标,仅用键盘走完注册到核心操作流程,检查能否到达并激活所有元素、焦点是否可见、能否用 Escape 关闭模态。自动化测试可运行 axe-core 或 Lighthouse 审计,按严重程度分组并修复 critical 与 serious,把无障碍检查加入 CI。深入测试可用 VoiceOver(Mac:Cmd+F5)或 NVDA(Windows,免费),200% 缩放,色盲模拟扩展,并确认视频有字幕。

常见错误:用 outline: none 去掉焦点样式、用 div 代替语义元素、用占位符当标签、忽略键盘用户、用 ARIA 修补坏 HTML、把无障碍拖到以后再做。

限制:资料未提供具体价格、平台支持范围或效果保证;部分内容为建议性清单,实际合规需自行验证。