SuperAPI AI 工具集

aria-allowed-attr

前端与建站

查看项目

更新于 10-16 05:29

技能介绍

用途

aria-allowed-attr 是前端检查清单(front-end-checklist)中的一条无障碍规则,适用于审查渲染后的 HTML、交互组件或设计系统模式。其核心目标是:确保每个 ARIA 角色只使用该角色允许的 ARIA 属性。

为什么重要

无效的 ARIA 属性会被屏幕阅读器忽略,或者可能导致屏幕阅读器误解元素的用途,从而为残障用户带来损坏的体验。使用不受支持的属性会混淆辅助技术,而遵循该规则可确保无障碍树保持有效且有意义。

主要能力

该规则提供以下环节:

  • 快速参考:说明每个 ARIA 角色只支持一组特定的 ARIA 属性;使用不受支持的属性会混淆辅助技术;确保无障碍树保持有效且有意义。
  • 检查(Check):验证元素上使用的所有 ARIA 属性对其所分配的 WAI-ARIA 角色是否有效。
  • 修复(Fix):移除或修正元素当前 ARIA 角色不支持的 ARIA 属性。
  • 解释(Explain):解释为什么只使用角色支持的 ARIA 属性对于正确的屏幕阅读器沟通是必要的。
  • 代码审查(Code Review):审查渲染后的标记以及影响“每个角色只使用允许的 ARIA 属性”这一规则的交互状态。标记出违反规则的具体元素、角色、标签、焦点行为或键盘交互,并说明如何通过浏览器无障碍工具或辅助技术验证修复效果。

使用方式

该规则以检查清单条目的形式提供,可用于代码审查和无障碍审查流程。完整的实现细节、代码示例和框架特定指南见 references/rule.md。规则页面为 https://frontendchecklist.io/rules/accessibility/aria-allowed-attr。

适用场景

  • 审查渲染后的 HTML 标记。
  • 审查交互组件。
  • 审查设计系统模式。
  • 代码审查中检查 ARIA 属性与角色的匹配情况。

限制

资料未提供该规则的具体代码示例、框架特定实现细节、安装命令或自动化工具集成方式,这些内容需参见 references/rule.md。资料也未提供收费、价格或平台相关信息。