Element: role 属性
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 |
浏览器兼容性
加载中…