SuperAPI AI 工具集

aria-valid-attr-value

前端与建站

查看项目

更新于 10-16 05:29

技能介绍

用途

aria-valid-attr-value 是前端检查清单(front-end-checklist)中无障碍(Accessibility)类别下的一条规则,主题为“为 ARIA 属性使用有效的值”。其核心目的是:确保 ARIA 属性的取值符合规范,避免因取值无效而导致辅助技术忽略或错误解读这些属性,从而造成用户界面状态传达错误、体验混乱。

主要能力

该规则围绕以下几点进行检查与修复:

  • 验证所有 ARIA 属性值是否符合允许的类型,例如布尔值(boolean)、整数(integer)、ID 列表(ID list)等。
  • 确保诸如 aria-expanded="true" 这类属性值有效。
  • 避免在需要 true/false 的地方使用 yes/no。
  • 检查 aria-labelledby 或 aria-owns 中引用的 ID 是否真实存在。

规则提供了“检查(Check)”“修复(Fix)”“解释(Explain)”三个层面的指引:检查属性值类型是否合规;将无效值修正为 ARIA 规范定义的格式;解释为何精确的属性值对浏览器向辅助技术正确传达元素状态是必要的。

使用方式

该规则主要用于代码审查(Code Review)场景:审查渲染后的标记(rendered markup)以及影响 ARIA 属性取值的交互状态,指出违反规则的具体元素、角色(role)、标签(label)、焦点行为或键盘交互,并说明如何通过浏览器无障碍工具或辅助技术验证修复结果。

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

适用场景

适用于审查渲染后的 HTML、交互组件,以及与“为 ARIA 属性使用有效值”相关的设计系统模式。

限制

资料未提供该规则的具体实现代码、框架适配细节、自动化检测工具集成方式或性能影响等信息,这些内容需参考规则页面及 references/rule.md。