用途
aria-roles 是前端检查清单(front-end-checklist)中的一条无障碍(accessibility)规则,标题为“使用有效的 ARIA role 值”。它用于在审查渲染后的 HTML、交互组件或设计系统模式时,发现与 ARIA role 使用相关的无障碍问题。
主要能力
该规则的核心检查点是:搜索任何使用非标准或拼写错误的 ARIA role 值的 role 属性。规则强调,无效或拼错的 ARIA role 会被浏览器和辅助技术忽略,使原本期望的无障碍功能失效,并可能让用户感到困惑。
规则给出的快速参考要点包括:
- 只使用 W3C 规范中定义的标准 ARIA role。
- 避免拼写错误或不存在的 role(例如应使用 checkbox,而不是 check-box)。
- 确保 role 应用于合适的 HTML 元素。
- 尽可能优先使用原生 HTML 控件,而不是自定义 ARIA 组件。
使用方式
规则按“检查—修复—解释—代码审查”的结构组织:
- 检查:搜索使用非标准或拼错 ARIA role 值的 role 属性。
- 修复:用 WAI-ARIA 规范中正确的标准值替换无效的 ARIA role;当原生 button、input、select 或其他语义元素可以替代自定义组件时,优先采用这种改动,而不是继续添加更多 ARIA。
- 解释:说明为什么使用标准化 ARIA role 对于辅助技术正确解释和播报元素至关重要,以及为什么原生 HTML 控件通常比用 ARIA 重建更可靠。
- 代码审查:审查渲染后的标记和影响该规则的交互状态,指出违反规则的具体元素、role、标签、焦点行为或键盘交互,并说明如何通过浏览器无障碍工具或辅助技术验证修复。
完整的实现细节、代码示例和针对特定框架的指导,见 references/rule.md。规则页面为 https://frontendchecklist.io/rules/accessibility/aria-roles。
适用场景
适用于审查渲染后的 HTML、交互组件或设计系统模式,尤其是涉及 ARIA role 使用的无障碍检查场景。
限制
资料未提供该规则的具体代码示例、框架特定实现细节、收费或价格信息,也未提供除规则页面和 references/rule.md 之外的更多资源说明。