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 |
瀏覽器相容性
載入中…