Accessibility Auditing 是一个用于审计网页无障碍问题的技能,其主要特点是不依赖外部工具,而是使用 Cursor 内置浏览器完成检查。
用途
该技能面向网页无障碍审计场景,通过 Cursor 的浏览器 aria 快照来发现页面中的无障碍缺陷,包括缺失标签、标签顺序错误、对比度问题以及 ARIA 误用。
主要能力
审计覆盖多个方面:
缺失标签:检查没有可访问名称的 button 元素(无文本、无 aria-label)、没有 alt 文本的 img、没有关联 label 或 aria-label 的 input、没有文本内容的 a 链接,以及仅有图标却缺少 aria-label 的按钮。
语义 HTML:识别可点击的 div 或 span(本应为 button 或 a)、缺失的 nav/main/header/footer 地标、跳级的标题(如 h1 直接到 h3),以及未使用 ul/ol/li 的列表。
键盘导航:发现未进入 Tab 顺序的交互元素、缺少 role 与键盘处理程序的自定义组件、模态框中的焦点陷阱(应捕获焦点但允许 Escape 关闭),以及缺失的跳转到内容链接。
ARIA 问题:检查可聚焦元素上的 aria-hidden="true"、无效的 role 值、没有对应可折叠内容的 aria-expanded、指向不存在 ID 的 aria-controls。
对比度:通过截图进行视觉检查,例如白底上的浅灰文字、过淡的占位符文本、难以区分的禁用状态。
使用方式
工作流分为六步:
- 使用 browser_navigate 打开目标 URL。
- 使用 browser_snapshot 捕获辅助功能树,该树与屏幕阅读器所用相同。
- 对树进行上述各项审计。
- 使用 browser_press 模拟 Tab 键测试键盘导航,验证每个交互元素都能获得焦点、焦点顺序符合从上到下与从左到右的逻辑、焦点可见(有焦点环或轮廓)、Escape 可关闭模态框或下拉菜单。
- 输出报告,按 Critical(严重)、Warnings(警告)、Passed(通过)分类。例如严重项列出 3 个无可访问名称的按钮(头部图标)和登录表单输入框缺少标签;警告项列出标题从 h1 跳到 h3、无跳转到内容链接、2 个可点击 div 应为按钮;通过项列出所有图片都有 alt 文本、存在地标(nav、main、footer)、焦点顺序合理。
- 修复:针对每个问题在源码中应用修复。常见修复包括为图标按钮添加 aria-label="Close"、将输入框包裹在 <label> 中或添加 htmlFor、把 <div onClick> 改为 <button>、为图片添加 alt 文本、修正标题层级。
适用场景
适合在 Cursor 中对前端页面进行无障碍自检与修复,尤其适合需要快速定位标签、语义、键盘导航和 ARIA 问题的开发过程。
限制
该技能依赖 Cursor 的浏览器能力,属于按流程执行的人工审计,而非独立的自动化无障碍检测工具;对比度部分依赖截图进行视觉判断。具体收费、价格、平台或效果等资料暂未提供。