01
输入实际 token
可输入 button、role=button 或 aria-expanded；类别筛选只在本页精选资料中查询，不会请求外部网站。
开发者参考资料
ARIA 角色与属性参考
按角色名或 aria-* 属性查询精选条目，查看正确示例、键盘要求与规范来源。
ARIA 角色
匹配条目
button
角色button 角色表示可触发动作的按钮；原生 button 已支持焦点和键盘激活。
键盘要求: 原生元素已处理焦点和基础按键；自定义角色需自行补齐。
注意: 原生元素已有同等语义和行为时，不要重复添加 role。
关键要求: 无
HTML 示例
<button type="button">Save</button>试用交互控件
已触发 0 次
查询只在本页进行；只有点击来源链接才会打开外部网站。
类别
已显示 1 / 共 16 条精选资料
WAI-ARIA 1.2 · 2023-06-06资料核对：2026-09-23
给自定义控件补无障碍角色时，先查 ARIA 角色 是否真有必要。原生 button、input 和 nav 往往已经具备语义与键盘行为，额外的 role 不会替你写交互。
这份 ARIA 角色 参考把常见属性、可复制示例与来源放在同一处。碰到 tab、dialog 等复合组件，还能直接打开 W3C 的完整交互模式。
为什么查 ARIA 角色 参考
先确认原生语义，再核对状态与行为。
原生控件优先
button 和 checkbox 条目先展示 HTML 原生写法。ARIA 角色 只改变辅助技术接收到的语义，给 div 加 role=button 不会自动获得焦点与按键响应。
状态和内容一起看
aria-expanded 示例把按钮与受控区域并列。查 ARIA 角色 时也应检查按钮状态是否随展开内容同步更新，不能只复制静态属性。
从查询词走到可用组件
02
先看交互再复制
ARIA 角色 示例只解决语义起点。tab、dialog、combobox 还需按链接中的 APG 模式补齐焦点、方向键或关闭行为。
03
核对版本并实测
每条链接指向固定的 WAI-ARIA 1.2 定义。把代码放进真实页面后，用键盘、屏幕阅读器和人工任务测试验证。
把定义和实现条件放在一起
角色与属性同查
首版收录 8 个角色和 8 个 aria-* 属性或状态；可按类别缩小范围，未命中不代表规范里没有该条目。
示例直达出处
每条都有 HTML 片段及对应 W3C 规范锚点；需要完整键盘模式的条目另附 APG 链接。
指出属性的能力边界
aria-expanded 表示展开状态，但不会自动打开面板；交互提示要求状态与真实界面同步。
这些示例不能替你判断什么
- 只收录精选条目
- 本页 ARIA 角色 与属性合计 16 条，不是完整词典。搜不到时请去规范索引核对，不能把未命中当成无效属性。
- 片段不是完整组件
- 复制 tab、dialog 或自定义 checkbox 的标记后，仍要实现焦点、键盘和状态更新，不能直接当成可交付组件。
- 不出合规结论
- 参考页不扫描实际 DOM，也不运行辅助技术测试。颜色比例请进入独立的对比度工具；全站是否符合 WCAG 仍需人工核查。
ARIA 角色 常见问题
什么时候需要给元素添加 ARIA 角色？
原生 HTML 已提供目标语义和行为时，优先使用原生元素，例如 button 或 checkbox。只有原生元素无法表达组件目的时，再考虑 ARIA 角色 并补齐交互。
role=button 会自动支持键盘操作吗？
不会。role=button 让辅助技术按按钮语义读出元素，但不会让 div 自动获得焦点或响应 Enter、Space。能用原生 button 时优先用它。
aria-label 和 aria-labelledby 有什么区别？
aria-label 直接写无障碍名称；aria-labelledby 引用页面中已有文本元素的 ID。可见文字和原生 label 合适时，先使用它们。
ARIA 角色需要哪些属性？
不同角色要求不同。结果卡列出关键状态与关系；完整的必需、支持及禁止属性请查看固定版本的 WAI-ARIA 1.2 原文。
只加 ARIA 属性就能通过无障碍测试吗？
不能。ARIA 角色 参考只能帮助查语义；真正的合规判断要结合页面内容、键盘路径、辅助技术表现及人工测试。
发现条目缺失或内容有误？