Element:role 属性
>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> |