免费在 GitHub 公开中文介绍

aria-required-attr

检查表明界面控件用途的ARIA角色是否具备必需属性，结合实际呈现的HTML和交互状态，帮助补充屏幕阅读器所需的状态与数值信息。

原文查看原文说明

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Include required ARIA attributes for roles. 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角色是否具备全部必需属性。例如，核查设置了role="slider"的元素是否缺少表示当前数值的aria-valuenow，并帮助添加缺失属性。通过检查实际呈现的HTML以及操作过程中的状态，指出存在问题的具体元素或角色。

适用场景

适合审查自定义交互控件，或在多个页面中重复使用的共用组件。检查时先确认标准HTML元素本身表达的含义，再根据需要检查键盘操作、焦点移动和无障碍名称。可用于核查屏幕阅读器获取的状态或数值信息是否充分。

使用示例

“检查此页面的ARIA角色是否具备WAI-ARIA规定的必需属性。”
“为自定义滑块补充缺失属性，让辅助技术能获取当前数值。”
“说明如何使用浏览器的无障碍工具或辅助技术验证修改后的状态。”

注意事项

无特别注意事项。

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

客观评估

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

指令清晰度能否看出何时使用、做什么: A良好明确要求在实际呈现的HTML和交互组件中检查ARIA角色的必需属性。
步骤具体性步骤、输入输出和示例是否具体: A良好以滑块的aria-valuenow为例，要求查缺、补充、报告问题元素并验证修正。
安全性发送数据、删除文件、执行命令等是否有说明: A良好修改范围是缺失的ARIA属性，未涉及外部发送、删除或凭据信息操作。
安装难易度所需工具和 API 密钥是否少且有说明: A良好无需专用服务或API密钥，验证方式包括浏览器无障碍工具。

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

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

包含的文件（2）

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

SKILL.md（原文）

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

Include required ARIA attributes for roles

Certain ARIA roles are incomplete without their required attributes, preventing assistive technologies from correctly communicating the element's state or value.

Quick Reference

Identify roles that require specific state or property attributes
Ensure attributes like aria-valuenow for sliders are present
Validate that all required ARIA attributes are correctly implemented

Check

Verify that all ARIA roles have their mandatory attributes as defined by the WAI-ARIA specification.

Fix

Add the missing required ARIA attributes to elements with specific roles (e.g., aria-valuenow for role="slider").

Explain

Explain how required ARIA attributes provide critical state information that screen readers need to function correctly.

Code Review

Review the rendered markup and interactive states that affect Include required ARIA attributes for roles. 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-required-attr

评价

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

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

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

同一仓库的技能