Element: role 属性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以来,此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

role 属性是 Element 接口的一部分,它返回为该元素明确设置的 WAI-ARIA 角色

所有 HTML 元素都具有隐式的 ARIA 角色,即使该角色是 generic。这种语义关联允许工具以与用户对该类型对象的期望一致的方式来呈现和支持与该对象的交互。role 属性用于显式设置元素的 ARIA 角色,从而覆盖隐式角色。例如,一个具有隐式 list 角色的 <ul> 元素,可以显式设置 role="treegrid"role 属性反映了 role 属性的显式设置值——在本例中是 treegrid;除非显式设置,否则它不会返回元素的隐式 list 角色。

定义的 ARIA 角色的完整列表可以在 ARIA 角色参考页面找到。

字符串;role 属性的值,如果未显式设置则为 null

示例

在此示例中,具有空或缺失 alt 属性的图像被赋予了 presentation 角色。

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

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# dom-ariamixin-role

浏览器兼容性

另见