Element: ariaLevel-Eigenschaft

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaLevel-Eigenschaft des Element-Interfaces spiegelt den Wert des aria-level-Attributs wider, welches die hierarchische Ebene eines Elements innerhalb einer Struktur definiert.

Hinweis: Verwenden Sie nach Möglichkeit ein HTML h1 oder eine andere korrekte Überschriftenebene, da diese eingebaute Semantik besitzen und keine ARIA-Attribute erfordern.

Wert

Ein String, der eine ganze Zahl enthält.

Beispiele

In diesem Beispiel wird das aria-level-Attribut des Elements mit der ID main-heading auf "1" gesetzt. Mit ariaLevel aktualisieren wir den Wert auf "2".

html
<div role="heading" id="main-heading" aria-level="1">
  This is a main page heading
</div>
js
let el = document.getElementById("main-heading");
console.log(el.ariaLevel); // "1"
el.ariaLevel = "2";
console.log(el.ariaLevel); // "2"

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-arialevel

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch