aria-level

Hierarchieebenen erscheinen in Überschriften, Bäumen, verschachtelten Grids, verschachtelten Listen und mehr. Wenn die DOM-Erbfolge die Ebene nicht genau darstellt, sollte das aria-level-Attribut verwendet werden, um die hierarchischen Ebenen in ihren Strukturen zu definieren. Die Ebenen steigen mit der Tiefe. Der Wert für aria-level ist eine ganze Zahl, die größer oder gleich 1 ist.

In Bezug auf die Überschriften in einer Dokumentstruktur können Sie Überschriften der ersten Ebene, der zweiten Ebene, der dritten Ebene usw. haben. In Bäumen haben Sie das Wurzelelement, seine Kinder, die Kinder der Kinder (oder Enkelkinder) und so weiter.

Das aria-level-Attribut macht Hierarchien für unterstützende Technologien sichtbar, sodass sie den Benutzern mitgeteilt werden können. Wie alle ARIA-Attribute hat es keinen Einfluss auf den User-Agent und damit auch keinen Einfluss auf die Bestimmung der Dokumentstruktur durch den User-Agent.

Wenn die DOM-Erbfolge die Ebene genau darstellt, kann der User-Agent die Ebene eines Elements aus der Dokumentstruktur berechnen, was aria-level nicht nur überflüssig macht, sondern auch das Risiko besteht, Fehlinformationen zu erzeugen. aria-level sollte wirklich nur verwendet werden, um eine explizite Angabe der Ebene bereitzustellen, wenn es nicht möglich ist, diese aus der Dokumentstruktur zu berechnen. 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 heading-Rolle, die unterstützenden Technologien anzeigt, dass das Element als Überschrift behandelt werden soll. <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 ein Unterabschnitt davon, und so weiter.

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

Verwenden Sie stattdessen die h1 bis h6-Elemente.

Im Fall eines treegrid wird aria-level bei Elementen mit der Rolle row unterstützt, nicht bei Elementen mit der Rolle gridcell. Reihen fungieren als Blattknoten in der vertikalen Orientierung des Grids. Gitterzellen sind Blattknoten in der horizontalen Orientierung jeder Zeile. Aria-level wird bei Zellen innerhalb von Reihen nicht unterstützt. In Baumgittern wird das aria-level-Attribut daher auf das Element mit der Rolle row angewendet.

Wenn ein vollständiger Satz verfügbarer Knoten im DOM aufgrund dynamischer Ladeprozesse bei Fokusänderung oder Scrollen im Baum nicht vorhanden ist, enthält jeder Knoten aria-level, aria-setsize und aria-posinset.

<integer>

Eine ganze Zahl, die größer oder gleich 1 ist

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überelemente (h1, h2, h3, h4, h5, und h6)