aria-level

aria-level 屬性定義了元素在結構中的層次結構級別。

描述

層次結構級別出現在標題、樹、巢狀網格、巢狀選項卡列表等中。如果 DOM 祖先關係不能準確地表示級別，則應使用 aria-level 屬性來定義其層次結構結構中的元素的層次結構級別。級別隨著深度的增加而增加。aria-level 的值為大於或等於 1 的整數。

在文件結構中的標題方面，您可以擁有第一級標題、第二級標題、第三級標題等。在樹中，您有根元素、其子元素、子元素的子元素（或孫元素）等等。

aria-level 屬性向輔助技術公開層次結構，以便可以將其傳達給使用者。與所有 ARIA 屬性一樣，它對使用者代理沒有影響，因此對使用者代理確定文件結構也沒有影響。

如果 DOM 祖先關係準確地表示級別，則使用者代理可以根據文件結構計算專案的級別，這使得 aria-level 不僅冗餘，而且存在建立錯誤資訊的風險。aria-level 實際上只應在無法根據文件結構計算級別時，用於提供級別的明確指示。測試以檢視是否需要此屬性。如果使用者代理可以計算級別，最好省略 aria-level 屬性。

使用 heading 角色

aria-level 屬性是 heading 角色的必需屬性，它指示輔助技術應將元素視為標題。<div role="heading" aria-level="1"> 將 <div> 定義為頁面上的主標題。使用 aria-level="2" 定義的二級標題將是第一個子部分，三級是該子部分的子部分，依此類推。

html
<div role="heading" aria-level="3">Heading for this sub section</div>

最好使用 h1 到 h6 元素。

在 treegrid 角色內

在 treegrid 的情況下，aria-level 在具有 row 角色的元素上受支援，而不是在具有 gridcell 角色的元素上受支援。行充當網格垂直方向中的葉節點。網格單元格是每行水平方向中的葉節點。Aria-level 不支援行中的單元格。因此，在樹狀網格中，aria-level 屬性應用於具有 row 角色的元素。

如果由於動態載入（當用戶在樹中移動焦點或滾動樹時）導致 DOM 中不存在完整的可用節點集，則每個節點都包含 aria-level、aria-setsize 和 aria-posinset。

值

<integer>

大於或等於 1 的整數

關聯介面

Element.ariaLevel

ariaLevel 屬性（Element 介面的一部分）反映了 aria-level 屬性的值。

ElementInternals.ariaLevel

ariaLevel 屬性（ElementInternals 介面的一部分）反映了 aria-level 屬性的值。

關聯角色

用於角色

規範

規範
可訪問的富網際網路應用程式 (WAI-ARIA)
# aria-level

另請參閱