SuperAPI AI 工具集

aria-valid-attr

前端与建站

查看项目

更新于 10-16 05:36

技能介绍

用途

aria-valid-attr 是前端检查清单(front-end-checklist)中一条关于无障碍(accessibility)的规则,主题为“确保 ARIA 属性有效”。它用于在审查已渲染的 HTML、交互组件或设计系统模式时,检查元素上使用的 ARIA 属性是否符合标准。

该规则的核心动机是:无效的 ARIA 属性会被浏览器和屏幕阅读器忽略,这可能导致残障用户无法导航或理解界面。因此,保证 ARIA 属性的有效性是无障碍实现的基础要求。

主要能力

该规则围绕四个环节展开:

  • 检查(Check):识别 HTML 元素上任何无效或拼写错误的 ARIA 属性。
  • 修复(Fix):将无效的 ARIA 属性替换为 WAI-ARIA 规范中定义的正确名称。
  • 解释(Explain):说明有效的 ARIA 属性如何使辅助技术能够向用户传达元素的状态和行为。
  • 代码审查(Code Review):审查影响该规则的已渲染标记和交互状态,标记违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何通过浏览器无障碍工具或辅助技术验证修复。

使用方式

该规则以快速参考的形式给出要点:

  • 只使用有效的、标准定义的 ARIA 属性。
  • 避免拼写错误或不存在的 aria-* 属性。
  • 确保屏幕阅读器正确解读元素的角色和状态。

在代码审查中,需要针对已渲染的标记和交互状态进行核对,指出具体违反规则的元素、角色、标签、焦点行为或键盘交互,并给出验证修复的方法。

完整的实现细节、代码示例和框架相关指导,参见 references/rule.md。规则页面为:https://frontendchecklist.io/rules/accessibility/aria-valid-attr

适用场景

适用于以下情形:审查已渲染的 HTML、交互组件,或与“确保 ARIA 属性有效”相关的设计系统模式。

限制

资料未提供该规则的具体代码示例、框架适配细节、自动化检测工具或评分标准,这些内容需参见 references/rule.md 与规则页面。资料也未说明该规则的收费、价格或平台信息。