大网数据广告活动
Web 标准与前端开发

Element:role 属性

· 52CE 我爱测

Element 接口的 **`role`** 属性返回为元素显式设置的 WAI-ARIA 角色。

DOM

Element 接口的 role 属性返回为元素显式设置的 WAI-ARIA 角色。

所有 HTML 元素都有隐式 ARIA 角色,即使该角色是 generic。这种语义关联使工具能够以符合用户对同类对象预期的方式呈现对象并支持与其交互。role 属性用于显式设置元素的 ARIA 角色,并覆盖隐式角色。例如,隐式角色为 list 的 ul 可显式设为 role="treegrid"。role 属性反映显式设置的 role 属性值——此例为 treegrid;除非显式设置,否则不会返回元素隐式的 list 角色。

已定义 ARIA 角色的完整列表见 ARIA 角色参考页。

值

字符串,即 role 属性值;若未显式设置则为 null。

示例

此示例会向 alt 属性为空或缺失的图像赋予 presentation role:

const images = document.querySelectorAll("img");
images.forEach((image) => {
  if (!image.alt) {
    image.role = "presentation";
  }
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。