免费在 GitHub 公开中文介绍

aria-allowed-attr

检查界面元素的角色是否支持所设置的ARIA属性，核对输出HTML和交互状态，指出不兼容的组合并指导删除或修正，帮助屏幕阅读器正确理解元素。

原文查看原文说明

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Use only allowed ARIA attributes for each role. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

thedaviddias/Front-End-Checklist

实测评分未实测

查看安装方法

适用场景

检查公共组件的ARIA属性
审查设计系统的无障碍支持
调查不符合预期的朗读
验证输出HTML与交互状态

中文介绍

功能

检查界面元素上的ARIA属性是否适用于该元素的角色。ARIA用于向辅助技术传达元素的含义和状态，不同角色支持的属性各不相同。审查会找出不受支持的组合，并指导删除或修正属性，使浏览器传递给辅助技术的信息具有合理、明确的含义。

适用场景

适合审查可交互控件、公共组件和设计系统。先确认原生HTML元素本身的语义，再检查实际输出的HTML以及交互过程中的状态。必要时，还会检查键盘操作、焦点移动和供辅助技术朗读的名称，并具体指出存在问题的元素。需要调查屏幕阅读器为何没有按预期朗读时，也可使用。

使用示例

“请检查这个组件的ARIA属性是否适用于它所设置的角色。”
“请调查朗读结果不符合预期的元素，并提出属性修改方案和验证方法。”

注意事项

没有特别注意事项。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果（实测对比）。

安全性发送数据、删除文件、执行命令等是否有说明: A良好范围是ARIA属性检查与修改，未记载对外发送、删除文件或读取凭据。
安装难易度所需工具和 API 密钥是否少且有说明: A良好提到浏览器无障碍工具和辅助技术，但未指定必需产品或API密钥。

不计入评分。由 AI（OpenAI Codex）于 2026年10月23日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（2）

SKILL.md1.8 KB
references/rule.md2.3 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Use only allowed ARIA attributes for each role

Invalid ARIA attributes are ignored by screen readers or may cause them to misinterpret the element's purpose, leading to a broken experience for users with disabilities.

Quick Reference

Each ARIA role only supports a specific set of ARIA attributes
Using unsupported attributes can confuse assistive technologies
Ensures the accessibility tree remains valid and meaningful

Check

Verify that all ARIA attributes used on elements are valid for their assigned WAI-ARIA roles.

Fix

Remove or correct ARIA attributes that are not supported by the element's current ARIA role.

Explain

Explain why using only role-supported ARIA attributes is necessary for proper screen reader communication.

Code Review

Review the rendered markup and interactive states that affect Use only allowed ARIA attributes for each role. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech.

For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/rules/accessibility/aria-allowed-attr

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能