Element: ariaLevel-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die ariaLevel-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-level-Attributs wider, das die hierarchische Ebene eines Elements innerhalb einer Struktur definiert.
Hinweis: Verwenden Sie, wenn möglich, ein HTML h1 oder eine andere korrekte Überschriftenebene, da diese eingebaute Semantik haben 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".
<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"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialevel |