SuperAPI AI 工具集

accessibility-compliance

前端与建站

查看项目

更新于 10-16 00:04

技能介绍

用途:为 QA Team Portal 等项目落地 WCAG 2.1 AA 无障碍合规要求,覆盖可感知、可操作、可理解、健壮四项原则,使页面在键盘与辅助技术下可用。

主要能力:使用语义化 HTML 替代 div 按钮与导航;为交互元素添加 ARIA 角色、标签与状态(如 aria-expanded、aria-controls、aria-modal);实现弹窗焦点陷阱、Esc 关闭与焦点归还;提供跳转到主内容链接;构建带 label、aria-invalid、aria-describedby 与 role="alert" 错误提示的可访问表单;用 :focus-visible 自定义焦点轮廓;校验色彩对比度(正文 4.5:1,大文本与 UI 组件 3:1);为图片提供替代文本与 figure/figcaption 长描述;用 aria-live 区域播报动态状态;实现带 caption、scope 的可访问数据表格;提供 sr-only 样式。

使用方式:按需将示例组件(Navigation、Modal、LoginForm、SkipToContent、TeamMembersTable、StatusMessage)集成到前端源码;样式放入 index.css;对比度校验使用 colorContrast.ts 的 getContrastRatio 与 meetsWCAGAA;自动化测试在 frontend 目录执行 npm install -D @axe-core/playwright,并用 axe_playwright_python 运行扫描,检查 violations。

适用场景:需要满足 WCAG 2.1 AA 的 Web 前端项目,尤其是表单、导航、弹窗、数据表格较多的管理类界面。

限制:资料以 React/TSX 与 Tailwind 风格示例为主,未提供完整依赖清单、构建配置、浏览器与屏幕阅读器兼容性实测结果,也未说明收费、授权与性能数据。