Element: ariaLevel 屬性

Baseline 2023

新推出

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

Element 介面的 ariaLevel 屬性反映了 aria-level 屬性的值，該屬性定義了元素在結構中的層級。

注意： 儘可能使用 HTML 的 h1 或其他正確的標題級別，因為它們具有內建的語義，不需要 ARIA 屬性。

值

包含整數的字串。

在此示例中，ID 為 main-heading 的元素上的 aria-level 屬性設定為 "1"。使用 ariaLevel，我們將值更新為 "2"。

html

<div role="heading" id="main-heading" aria-level="1">
  This is a main page heading
</div>

let el = document.getElementById("main-heading");
console.log(el.ariaLevel); // "1"
el.ariaLevel = "2";
console.log(el.ariaLevel); // "2"

規範
無障礙富網際網路應用程式 (WAI-ARIA) # dom-ariamixin-arialevel

此頁面最後修改於 2025年3月6日，由 MDN 貢獻者修改。