SuperAPI AI 工具集

wcag-audit-patterns

前端与建站

查看项目

更新于 10-16 09:32

技能介绍

该技能用于依据 WCAG 2.2 指南对网页内容进行无障碍审计,并给出可执行的修复策略。适用场景包括:开展无障碍审计、修复 WCAG 违规、实现无障碍组件、应对无障碍相关法律风险、满足 ADA/Section 508 要求以及达成 VPAT 合规。

核心概念包括:一致性级别(A 为法律底线、AA 为多数法规要求、AAA 针对特殊需求)与 POUR 原则(可感知、可操作、可理解、健壮)。常见违规按影响分为:严重阻塞类(功能性图片缺少替代文本、交互元素无键盘访问、表单缺少标签、自动播放媒体无控制)、较严重类(对比度不足、缺少跳转链接、自定义组件不可访问、缺少页面标题)、中等问题(缺少语言属性、链接文本不清晰、缺少地标、标题层级不当)。

审计清单覆盖四个原则:可感知(文本替代、时基媒体、可适配性、可区分性,如 4.5:1 文本对比度、200% 缩放、400% 重排、非文本对比度与文本间距要求);可操作(键盘可访问、无键盘陷阱、时间可调、可暂停停止隐藏、三次闪烁限制、可导航性如跳过块、页面标题、焦点顺序、焦点可见与焦点不被遮挡);可理解(页面与局部语言、可预测行为、错误识别与纠正建议、错误预防);健壮(名称角色值、状态消息的实时区域)。

自动化测试可使用 axe-core 集成,配合 Playwright 测试,或使用命令行工具:npx @axe-core/cli https://example.com、npx pa11y https://example.com、lighthouse https://example.com --only-categories=accessibility。注意自动化仅能发现约 30-50% 的问题,仍需人工验证,优先使用语义化 HTML 而非 ARIA,不应隐藏焦点轮廓或禁用缩放。资料中未提供具体定价或平台支持信息。