ARIA: aria-level Attribut
Das aria-level Attribut definiert die hierarchische Ebene eines Elements innerhalb einer Struktur.
Beschreibung
Hierarchieebenen erscheinen in Überschriften, Bäumen, verschachtelten Rasterstrukturen, verschachtelten Registerkartenlisten und mehr. Wenn die DOM-Vorfahren die Ebene nicht genau wiedergeben, sollte das aria-level Attribut verwendet werden, um die hierarchischen Ebenen von Elementen innerhalb ihrer hierarchischen 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 die Hierarchie für unterstützende Technologien sichtbar, sodass sie den Nutzern mitgeteilt werden kann. Wie alle ARIA-Attribute hat es keinen Einfluss auf den User-Agent und damit keinen Einfluss auf die Bestimmung der Dokumentenstruktur durch den User-Agent.
Wenn die DOM-Vorfahren die Ebene genau wiedergeben, kann der User-Agent die Ebene eines Elements aus der Dokumentenstruktur berechnen, wodurch aria-level nicht nur überflüssig, sondern auch eine Gefahr für falsche Informationen darstellt. aria-level sollte wirklich nur verwendet werden, um eine explizite Angabe der Ebene zu liefern, wenn es nicht möglich ist, diese aus der Dokumentenstruktur 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.
Mit der Rolle heading
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 die Hauptüberschrift der Seite. Eine Überschrift der Ebene 2, definiert mit aria-level="2", wäre der erste Unterabschnitt, eine Ebene 3 ist ein Unterabschnitt davon, und so weiter.
<div role="heading" aria-level="3">Heading for this sub section</div>
Innerhalb der Rolle treegrid
Im Fall eines treegrid wird aria-level auf Elementen unterstützt, die die Rolle row haben, nicht auf Elementen mit der Rolle gridcell. Reihen fungieren als Blattknoten innerhalb der vertikalen Ausrichtung des Rasters. Rasterzellen sind Blattknoten innerhalb der horizontalen Ausrichtung jeder Reihe. Aria-level wird nicht auf Zellen innerhalb von Reihen unterstützt. In Baumstrukturen 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 nicht im DOM vorhanden ist, während der Benutzer den Fokus bewegt oder durch den Baum scrollt, hat jeder Knoten aria-level, aria-setsize und aria-posinset hinzugefügt.
Werte
<integer>-
Eine ganze Zahl, die größer oder gleich 1 ist
Zugehörige Schnittstellen
Element.ariaLevel-
Die
ariaLevelEigenschaft, Teil derElementSchnittstelle, spiegelt den Wert desaria-levelAttributs wider. ElementInternals.ariaLevel-
Die
ariaLevelEigenschaft, Teil derElementInternalsSchnittstelle, spiegelt den Wert desaria-levelAttributs wider.
Zugehörige Rollen
Verwendet in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-level |