SuperAPI AI 工具集

behavioral-a11y

测试与质量

查看项目

更新于 10-16 00:29

技能介绍

用途:面向“行为无障碍自动化”——即真正操作已渲染页面(缩放视口、按 Tab、悬停、等待)并观察结果的检查,而不是只看静态标记或单一计算后的无障碍树。静态检查无法回答使用中才出现的问题:窄视口下布局是否仍可用、键盘用户是否能看到焦点提示、缩放或加间距后内容是否被裁切、动态状态是否保持同等保证。

主要能力:结果必须使用统一词汇——Indicator(观察到疑似障碍信号,但未排除合理解释,需人工复核)、Confirmed failure(已满足排除常见假阴性前提,仅针对该次被测实例,仍不等于合规)、cantTell(无法得出可靠结论,如页面未稳定)、Test error(检查自身执行失败)、Manual review required(自动化不尝试判定的类别,如 SC 1.4.10 例外是否成立、指示器对比度或尺寸、焦点顺序是否合乎逻辑)。Reflow 风险检查(SC 1.4.10):设 320×720 CSS 像素、等待稳定、尝试横向滚动、读取滚动量与 clientWidth/scrollWidth,尽最大努力定位溢出元素。Focus Visible 风险检查(SC 2.4.7):逐 Tab 停靠点记录活动元素、发送真实 Tab 键、解析开放 shadow root 中最深元素、对元素周围加内边距区域截图并与失焦参照比对,采用区域比对而非整页比对。

使用方式:每项检查需声明视口、时序与稳定化假设,输出机器可读证据(选择器、矩形、HTML 片段),并注明已知误报与漏报风险。建议节奏:组件样本与变更页面每 PR 运行,代表性模板每 PR 运行,全站清单按计划(夜间/每周)运行,每个根因簇抽人工复核,定期抽样干净结果。

限制:Reflow 无法发现无滚动条的裁切(overflow: hidden)、无法判断例外是否适用、无法捕捉短于静默期的延迟布局变化;Focus Visible 无法判定对比度、尺寸或可用性,不检测被 sticky 元素遮挡,不处理跨源 iframe,不覆盖非 Tab 触发的焦点。SC 1.4.4、1.4.12、1.4.13、2.4.11 尚未自动化,不得宣称覆盖。误报与不稳定不同:误报是测试完成但结论错误,不稳定是同目标重复运行结果不一致。全站规模下误报概率会累积,且网站发现常具相关性,应做根因聚类,报告为“1 个唯一缺陷、N 个受影响实例、1 个根因簇”。阻断通常只应用于确定性失败或对已审阅基线的可复现回归。所有结果,无论单独或汇总,都不确立 WCAG 合规。目标标准为 WCAG 2.2 AA。