免费在 GitHub 公开中文介绍

aria-valid-attr-value

检查向辅助技术传达界面状态和标签的ARIA属性值，找出布尔值写法错误及引用ID缺失的问题，并提供符合规范的修正方法和验证步骤。

原文查看原文说明

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

thedaviddias/Front-End-Checklist

AI 评分100分/ 100 查看安装方法

适用场景

检查交互控件的ARIA属性
核对ARIA属性引用的ID
发布前验证无障碍修正

中文介绍

功能

ARIA属性用于向辅助技术传达元素的状态、标签等信息。此技能检查渲染后的HTML，确认属性值是否符合规范要求的格式，例如布尔值、整数或ID列表。它会指出应使用true/false却写成yes/no的情况，以及aria-labelledby、aria-owns引用的ID不存在的问题，并说明如何修正。

适用场景

适合审查按钮、可展开面板等交互控件及共用界面的无障碍设计。检查时先确认HTML原生语义，再根据需要查看键盘操作、焦点移动和屏幕阅读器的朗读内容。需要整理存在问题的元素，以及修正后的验证方法时，也可以使用。

使用示例

“检查这个可展开面板的ARIA属性值，修正格式不符合要求的地方。”
“核对aria-labelledby引用的ID是否存在，并说明如何使用浏览器的无障碍工具验证结果。”

注意事项

没有特别注意事项。

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

客观评估

AI 仅根据 SKILL.md 的内容，从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么: A良好资料明确说明使用场景是审查渲染后的HTML，检查对象是ARIA属性值。
步骤具体性步骤、输入输出和示例是否具体: A良好资料列出布尔值及引用ID的检查示例、修正方向，以及问题元素和验证方法的报告要求。
安全性发送数据、删除文件、执行命令等是否有说明: A良好范围为检查和修正属性值，未记载涉及对外发送或删除的操作。
安装难易度所需工具和 API 密钥是否少且有说明: A良好可用浏览器无障碍工具或辅助技术验证，未指定专用服务或API密钥。

总分按每项 A=25 分、B=15 分、C=5 分相加。由 AI（OpenAI Codex）于 2026年10月23日评估。仅供参考，安装前请同时查看原文。

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

包含的文件（2）

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

SKILL.md（原文）

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

Use valid values for ARIA attributes

Invalid attribute values cause ARIA properties to be ignored or misinterpreted by assistive technologies, leading to a broken or confusing user experience.

Quick Reference

Ensure ARIA attribute values (like aria-expanded="true") are valid
Avoid using "yes/no" where "true/false" is required
Check that IDs referenced in aria-labelledby or aria-owns actually exist

Check

Validate that all ARIA attribute values conform to the allowed types (boolean, integer, ID list, etc.).

Fix

Correct any invalid ARIA attribute values to match the expected format defined in the ARIA specification.

Explain

Explain why precise attribute values are necessary for browsers to correctly communicate element states to assistive technology.

Code Review

Review the rendered markup and interactive states that affect Use valid values for ARIA attributes. 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-valid-attr-value

评价

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

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

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

同一仓库的技能