此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:role 属性

基线 广泛可用

自 2023年10月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

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

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

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

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

示例

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

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

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-role

浏览器兼容性

参见