用途:对指定 URL 运行 WCAG 2.1 AA+ 无障碍(a11y)测试,适合需要检查无障碍合规、屏幕阅读器支持或键盘可用性的场景。方法是通过 4 个并行子代理各自打开浏览器会话独立执行,共 40 个测试用例,结束后合并为报告。
主要能力分四类。结构(TC-A1 至 TC-A10):ARIA 标签与角色、标题层级、地标区域、跳转导航链接、页面标题、html lang、列表与表格语义、重复 ID。键盘(TC-A11 至 TC-A20):Tab 可达性与顺序、焦点可见性、模态焦点陷阱与焦点返还、下拉菜单键盘操作、键盘陷阱、Escape 关闭浮层、按钮链接激活、自定义控件键盘支持。内容(TC-A21 至 TC-A30):图片 alt、AA 与 AAA 色彩对比度、非仅靠颜色传达信息、表单标签关联、错误消息关联、必填标记、链接文本描述、200% 文字缩放。动态(TC-A31 至 TC-A40):ARIA live 区域、加载状态播报、错误播报、aria-expanded、选项卡角色、轮播键盘支持、工具提示、prefers-reduced-motion、combobox 的 aria-activedescendant、进度指示器标签。
使用方式:默认 URL 为 http://localhost:3000,可通过参数覆盖;结果按时间戳输出到 test-results/test-a11y/<TIMESTAMP>,含 screenshots、snapshots、traces 目录。执行命令形如 playwright-cli -s=a11y-structure open "$URL",各代理分别以 -s=a11y-structure、-s=a11y-keyboard、-s=a11y-content、-s=a11y-dynamic 启动,配合 tracing-start、snapshot、screenshot、tracing-stop、close。
限制:需具备 Playwright 与 playwright-cli 环境;具体报告格式见 references/report-format.md,本资料未提供该文件内容;部分用例在页面对应组件不存在时无法执行;其余收费、平台与效果信息暂未提供。