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