ARIA-Zustände und -Eigenschaften (Attribute)
Diese Seite listet Referenzseiten auf, die alle auf MDN besprochenen WAI-ARIA-Attribute abdecken.
ARIA-Attribute ermöglichen es, die Zustände und Eigenschaften eines Elements zu ändern, wie im Accessibility-Tree definiert.
Hinweis: ARIA ändert nur den Accessibility-Tree, indem es beeinflusst, wie assistive Technologie den Inhalt Ihren Nutzern präsentiert. ARIA ändert nichts an der Funktion oder dem Verhalten eines Elements. Wenn semantische HTML-Elemente nicht für ihren beabsichtigten Zweck und ihre Standardfunktionalität verwendet werden, müssen Sie JavaScript verwenden, um Verhalten, Fokus und ARIA-Zustände zu verwalten.
ARIA-Attributtypen
Es gibt 4 Kategorien von ARIA-Zuständen und -Eigenschaften:
Widget-Attribute
aria-autocompletearia-checkedaria-disabledaria-errormessagearia-expandedaria-haspopuparia-hiddenaria-invalidaria-labelaria-levelaria-modalaria-multilinearia-multiselectablearia-orientationaria-placeholderaria-pressedaria-readonlyaria-requiredaria-selectedaria-sortaria-valuemaxaria-valueminaria-valuenowaria-valuetext
Live-Region-Attribute
Drag-and-Drop-Attribute
Beziehungs-Attribute
Globale ARIA-Attribute
Einige Zustände und Eigenschaften gelten für alle HTML-Elemente, unabhängig davon, ob eine ARIA-Rolle angewendet wird. Diese werden als "Globale" Attribute definiert. Globale Zustände und Eigenschaften werden von allen Rollen und grundlegenden Markup-Elementen unterstützt.
Viele der oben genannten Attribute sind global, was bedeutet, dass sie, sofern nicht ausdrücklich ausgeschlossen, in jedes Element eingefügt werden können:
aria-atomicaria-busyaria-controlsaria-currentaria-describedbyaria-descriptionaria-detailsaria-disabledaria-dropeffectaria-errormessagearia-flowtoaria-grabbedaria-haspopuparia-hiddenaria-invalidaria-keyshortcutsaria-labelaria-labelledbyaria-livearia-ownsaria-relevantaria-roledescription
Mit "ausdrücklich ausgeschlossen" sind alle oben genannten Attribute global, außer den Eigenschaften aria-label und aria-labelledby, die nicht auf Elemente mit der Rolle presentation oder ihrem Synonym none angewendet werden dürfen.
Index der Zustände und Eigenschaften
Die folgenden sind die Referenzseiten, die die auf WAI-ARIA-Zustände und Eigenschaften auf MDN beschreiben.
- ARIA: aria-activedescendant Attribut
Das
aria-activedescendantAttribut identifiziert das derzeit aktive Element, wenn der Fokus auf einemcompositeWidget,combobox,textbox,groupoderapplicationliegt.- ARIA: aria-atomic Attribut
In ARIA Live-Regionen gibt das globale
aria-atomicAttribut an, ob unterstützende Technologien wie ein Screenreader den gesamten geänderten Bereich oder nur Teile davon präsentieren, basierend auf den Änderungsbenachrichtigungen, die durch dasaria-relevantAttribut definiert sind.- ARIA: aria-autocomplete Attribut
Das
aria-autocompleteAttribut gibt an, ob die Eingabe von Text eine Anzeige von einer oder mehreren Vorhersagen für den beabsichtigten Wert des Benutzers für einecombobox,searchboxodertextboxauslösen könnte und wie Vorhersagen präsentiert werden, falls sie getroffen werden.- ARIA: aria-braillelabel Attribut
Das globale
aria-braillelabelAttribut definiert einen Zeichenfolgenwert, der das aktuelle Element kennzeichnet und in Braille umgewandelt werden soll.- ARIA: aria-brailleroledescription-Attribut
Das globale
aria-brailleroledescription-Attribut definiert eine für Menschen lesbare, vom Autor lokalisierte, abgekürzte Beschreibung der Rolle eines Elements, die in Braille umgewandelt werden soll.- ARIA: aria-busy-Attribut
Das
aria-busy-Attribut ist ein globaler ARIA-Zustand, der anzeigt, ob ein Element derzeit verändert wird. Es hilft unterstützenden Technologien zu verstehen, dass Änderungen am Inhalt noch nicht abgeschlossen sind und dass es möglicherweise ratsam ist, mit der Information des Nutzers über die Aktualisierung zu warten. Währendaria-busyhäufig in ARIA-Live-Regionen verwendet wird, um Ankündigungen zu verzögern, bis die Aktualisierungen abgeschlossen sind, kann es auch außerhalb von Live-Regionen verwendet werden – zum Beispiel in Widgets oder Feeds –, um laufende Änderungen oder Ladevorgänge anzuzeigen.- ARIA: aria-checked-Attribut
Das Attribut
aria-checkedgibt den aktuellen Zustand „aktiviert“ von Kontrollkästchen, Optionsfeldern und anderen Widgets an.- ARIA: aria-colcount-Attribut
Das
aria-colcount-Attribut definiert die Gesamtanzahl der Spalten in einertable,gridodertreegrid, wenn nicht alle Spalten im DOM vorhanden sind.- ARIA: aria-colindex Attribut
Das
aria-colindexAttribut definiert den Spaltenindex oder die Position eines Elements in Bezug auf die Gesamtzahl der Spalten innerhalb einestable,gridodertreegrid.- ARIA: aria-colindextext Attribut
Das
aria-colindextextAttribut definiert einen menschenlesbaren Text als Alternative zum numerischenaria-colindex.- ARIA: aria-colspan-Attribut
Das Attribut
aria-colspandefiniert die Anzahl der Spalten, über die sich eine Zelle oder gridcell innerhalb einertable, einesgridoder einestreegriderstreckt.- ARIA: aria-description-Attribut
Das globale
aria-description-Attribut definiert einen Zeichenfolgenwert, der das aktuelle Element beschreibt oder kommentiert.- ARIA: aria-details-Attribut
Das globale Attribut
aria-detailsidentifiziert das Element (oder die Elemente), das zusätzliche Informationen zu einem Objekt bereitstellt.- ARIA: aria-disabled-Attribut
Der
aria-disabled-Zustand zeigt an, dass das Element wahrnehmbar, aber deaktiviert ist, sodass es nicht bearbeitbar oder anderweitig bedienbar ist.- ARIA: aria-dropeffect-Attribut
Das globale
aria-dropeffect-Attribut zeigt an, welche Funktionen ausgeführt werden können, wenn ein gezogenes Objekt auf dem Ziel abgelegt wird.- ARIA: aria-flowto-Attribut
Das globale
aria-flowto-Attribut identifiziert das nächste Element (oder die nächsten Elemente) in einer alternativen Lesereihenfolge von Inhalten. Dadurch kann unterstützende Technologie die allgemeine voreingestellte Lesereihenfolge im Dokument nach eigenem Ermessen überschreiben.- ARIA: aria-grabbed-Attribut
Der
aria-grabbed-Zustand zeigt den "gegriffenen" Zustand eines Elements in einer Drag-and-Drop-Operation an.- ARIA: aria-haspopup-Attribut
Das
aria-haspopup-Attribut gibt die Verfügbarkeit und den Typ eines interaktiven Popup-Elements an, das durch das Element, auf dem das Attribut gesetzt ist, ausgelöst werden kann.Der Zustand
aria-hiddengibt an, ob ein Element über eine Barrierefreiheits-API zugänglich ist.- ARIA: aria-keyshortcuts-Attribut
Das globale Attribut
aria-keyshortcutsgibt Tastenkombinationen an, die ein Autor implementiert hat, um ein Element zu aktivieren oder ihm den Fokus zu geben.- ARIA: aria-label Attribut
Das
aria-labelAttribut definiert einen Zeichenfolgewert, der verwendet werden kann, um ein Element zu benennen, solange die Rolle des Elements das Benennen nicht untersagt.- ARIA: aria-labelledby-Attribut
Das
aria-labelledby-Attribut identifiziert das Element (oder die Elemente), das bzw. die dasjenige Element beschriftet/beschriften, auf das es angewendet wird.- ARIA: aria-level Attribut
Das
aria-levelAttribut definiert die hierarchische Ebene eines Elements innerhalb einer Struktur.- ARIA: aria-live-Attribut
Das globale
aria-live-Attribut zeigt an, dass ein Element aktualisiert wird und beschreibt die Arten von Aktualisierungen, die Benutzeragenten, unterstützende Technologien und der Benutzer von der Live-Region erwarten können.- ARIA: aria-modal-Attribut
Das Attribut
aria-modalgibt an, ob ein Element bei seiner Anzeige modal ist.- ARIA: aria-multiline Attribut
Das
aria-multilineAttribut gibt an, ob eintextboxmehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile.- ARIA: aria-orientation-Attribut
Das
aria-orientation-Attribut gibt an, ob die Ausrichtung eines Elements horizontal, vertikal oder unbekannt/mehrdeutig ist.- ARIA: aria-owns-Attribut
Das
aria-owns-Attribut identifiziert ein Element (oder Elemente), um eine visuelle, funktionale oder kontextuelle Beziehung zwischen einem übergeordneten Element und dessen untergeordneten Elementen zu definieren, wenn die DOM-Hierarchie zur Darstellung der Beziehung nicht verwendet werden kann.- ARIA: aria-placeholder-Attribut
Das
aria-placeholder-Attribut definiert einen kurzen Hinweis (ein Wort oder eine kurze Phrase), der dem Benutzer bei der Dateneingabe helfen soll, wenn ein Formularelement keinen Wert hat. Der Hinweis kann ein Beispielwert oder eine kurze Beschreibung des erwarteten Formats sein.- ARIA: aria-posinset Attribut
Das
aria-posinsetAttribut definiert die Nummer oder Position eines Elements in der aktuellen Gruppe von Listenelementen oder Baumelementen, wenn nicht alle Elemente im DOM vorhanden sind.- ARIA: aria-readonly-Attribut
Das Attribut
aria-readonlygibt an, dass das Element nicht bearbeitbar, aber ansonsten bedienbar ist.- ARIA: aria-relevant Attribut
Verwendet in ARIA-Live-Regionen zeigt das globale
aria-relevantAttribut an, welche Benachrichtigungen der User-Agent auslöst, wenn der Zugänglichkeitsbaum innerhalb einer Live-Region modifiziert wird.- ARIA: aria-required-Attribut
Das Attribut
aria-requiredgibt an, dass für ein Element eine Benutzereingabe erforderlich ist, bevor ein Formular abgeschickt werden kann.- ARIA: aria-roledescription-Attribut
Das Attribut
aria-roledescriptiondefiniert eine menschenlesbare, vom Autor lokalisierte Beschreibung für die Rolle eines Elements.- ARIA: aria-rowindex-Attribut
Das Attribut
aria-rowindexdefiniert die Position eines Elements im Verhältnis zur Gesamtzahl der Zeilen in einer Tabelle, einem Grid oder einem Treegrid.- ARIA: aria-rowindextext Attribut
Das
aria-rowindextextAttribut definiert eine menschenlesbare Textalternative zuaria-rowindex.- ARIA: aria-rowspan Attribut
Das
aria-rowspanAttribut definiert die Anzahl der von einer Zelle oder Gridcell innerhalb einer Tabelle, eines Grids oder Treegrids überspannten Reihen.- ARIA: aria-selected-Attribut
Das Attribut
aria-selectedgibt den aktuellen Auswahlzustand verschiedener Widgets an.- ARIA: aria-setsize-Attribut
Das Attribut
aria-setsizedefiniert die Anzahl der Elemente in der aktuellen Gruppe von listitems oder treeitems, wenn nicht alle Elemente der Gruppe im DOM vorhanden sind.- ARIA: aria-valuemax-Attribut
Das Attribut
aria-valuemaxdefiniert den maximal zulässigen Wert für ein Bereichs-Widget.- ARIA: aria-valuemin Attribut
Das
aria-valueminAttribut definiert den minimal erlaubten Wert für ein Bereichs-Widget.- ARIA: aria-valuenow-Attribut
Das Attribut
aria-valuenowdefiniert den aktuellen Wert einesrange-Widgets.- ARIA: aria-valuetext-Attribut
Das
aria-valuetext-Attribut definiert den menschenlesbaren Text als Alternative zuaria-valuenowfür ein Bereichs-Widget.- ARIA: Attribut aria-controls
Die globale Eigenschaft
aria-controlsidentifiziert das Element (oder die Elemente), dessen Inhalt oder Vorhandensein durch das Element gesteuert wird, auf dem dieses Attribut gesetzt ist.- ARIA: Attribut aria-current
Ein nicht auf
nullgesetzter Zustand vonaria-currentan einem Element zeigt an, dass dieses Element das aktuelle Element innerhalb eines Containers oder einer Gruppe zusammengehöriger Elemente darstellt.- ARIA: Attribut aria-describedby
Das globale Attribut
aria-describedbygibt das Element (oder die Elemente) an, das das Element beschreibt, auf dem das Attribut gesetzt ist.- ARIA: Attribut aria-errormessage
Das Attribut
aria-errormessageeines Objekts gibt das Element oder die Elemente an, die eine Fehlermeldung für dieses Objekt bereitstellen.- ARIA: Attribut aria-expanded
Das Attribut
aria-expandedwird für ein Element festgelegt, um anzugeben, ob ein Steuerelement erweitert oder eingeklappt ist und ob die gesteuerten Elemente angezeigt oder ausgeblendet werden.- ARIA: Attribut aria-invalid
Der Zustand
aria-invalidgibt an, dass der eingegebene Wert nicht dem von der Anwendung erwarteten Format entspricht.- ARIA: Attribut aria-multiselectable
Das Attribut
aria-multiselectablegibt an, dass Benutzer mehr als ein Element aus den aktuell auswählbaren Nachfahren auswählen können.- ARIA: Attribut aria-pressed
Das Attribut
aria-pressedgibt den aktuellen "gedrückten" Zustand eines Umschaltknopfs an.- ARIA: Attribut aria-rowcount
Das Attribut
aria-rowcountdefiniert die Gesamtzahl der Zeilen in einer Tabelle, einem Grid oder einem Treegrid.- ARIA: Attribut aria-sort
Das Attribut
aria-sortgibt an, ob Elemente in einer Tabelle oder einem Grid aufsteigend oder absteigend sortiert sind.