Element: role 屬性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以來,此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

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

瀏覽器相容性

另見