SuperAPI AI 工具集

aria-roles

前端与建站

查看项目

更新于 10-16 05:25

技能介绍

用途

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 之外的更多资源说明。