aria-level

Hierarchieebenen erscheinen in Überschriften, Bäumen, verschachtelten Gittern, verschachtelten Tabellisten und mehr. Wenn die DOM-Abstammung die Ebene nicht genau darstellt, sollte das aria-level-Attribut verwendet werden, um die hierarchischen Ebenen der Elemente innerhalb ihrer hierarchischen Strukturen zu definieren. Die Ebenen erhöhen sich mit der Tiefe. Der Wert für aria-level ist eine ganze Zahl größer oder gleich 1.

Bei Dokumentstrukturen gibt es beispielsweise erste Überschriftenebenen, zweite Überschriftenebenen, dritte Überschriftenebenen usw. In Bäumen haben Sie das Wurzelelement, dessen Kinder, die Kinder der Kinder (oder Enkel) und so weiter.

Das aria-level-Attribut macht Hierarchien assistiven Technologien zugänglich, damit sie den Nutzern kommuniziert werden können. Wie alle ARIA-Attribute hat es keinen Einfluss auf den User-Agent und somit keinen Einfluss auf die Bestimmung der Dokumentstruktur durch den User-Agent.

Wenn die DOM-Abstammung die Ebene genau darstellt, kann der User-Agent die Ebene eines Elements aus der Dokumentstruktur berechnen, wodurch aria-level nicht nur redundant, sondern auch ein Risiko für Fehlinformationen wird. Aria-level sollte wirklich nur verwendet werden, um eine explizite Anzeige der Ebene zu geben, wenn dies nicht aus der Dokumentstruktur berechnet werden kann. Testen Sie, ob dieses Attribut benötigt wird. Wenn der User-Agent die Ebene berechnen kann, ist es am besten, das aria-level-Attribut wegzulassen.

Das aria-level-Attribut ist ein erforderliches Attribut der Rolle heading, die assistiven Technologien anzeigt, dass das Element als Überschrift behandelt werden sollte. <div role="heading" aria-level="1"> definiert das <div> als Hauptüberschrift der Seite. Eine Ebene-2-Überschrift, definiert mit aria-level="2", wäre der erste Unterabschnitt, eine Ebene-3 wäre ein Unterabschnitt davon, und so weiter.

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

Es ist besser, die h1 bis h6 Elemente zu verwenden.

Im Fall eines treegrid wird aria-level auf Elemente mit der Rolle row unterstützt, nicht auf Elemente mit der Rolle gridcell. Reihen fungieren als Blattknoten innerhalb der vertikalen Orientierung des Gitters. Rasterzellen sind Blattknoten innerhalb der horizontalen Orientierung jeder Reihe. Aria-level wird nicht auf Zellen innerhalb von Reihen unterstützt. In Treegrids wird das aria-level-Attribut also auf das Element mit der Rolle row angewendet.

Wenn ein vollständiger Satz verfügbarer Knoten aufgrund dynamischen Ladens, während der Benutzer den Fokus verschiebt oder im Baum scrollt, nicht im DOM vorhanden ist, hat jeder Knoten aria-level, aria-setsize und aria-posinset enthalten.

<integer>

Eine ganze Zahl größer oder gleich 1

Element.ariaLevel

Die ariaLevel-Eigenschaft, Teil der Element-Schnittstelle, spiegelt den Wert des aria-level-Attributs wider.

ElementInternals.ariaLevel

Die ariaLevel-Eigenschaft, Teil der ElementInternals-Schnittstelle, spiegelt den Wert des aria-level-Attributs wider.

Verwendet in Rollen:

• associationlistitemkey
• comment
• heading
• row

• <h1> bis <h6>: Die HTML Abschnittsüberschriftselemente (h1, h2, h3, h4, h5, und h6)