Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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:

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-activedescendant Attribut identifiziert das derzeit aktive Element, wenn der Fokus auf einem composite Widget, combobox, textbox, group oder application liegt.

ARIA: aria-atomic Attribut

In ARIA Live-Regionen gibt das globale aria-atomic Attribut 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 das aria-relevant Attribut definiert sind.

ARIA: aria-autocomplete Attribut

Das aria-autocomplete Attribut gibt an, ob die Eingabe von Text eine Anzeige von einer oder mehreren Vorhersagen für den beabsichtigten Wert des Benutzers für eine combobox, searchbox oder textbox auslösen könnte und wie Vorhersagen präsentiert werden, falls sie getroffen werden.

ARIA: aria-braillelabel Attribut

Das globale aria-braillelabel Attribut 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ährend aria-busy hä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-checked gibt 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 einer table, grid oder treegrid, wenn nicht alle Spalten im DOM vorhanden sind.

ARIA: aria-colindex Attribut

Das aria-colindex Attribut definiert den Spaltenindex oder die Position eines Elements in Bezug auf die Gesamtzahl der Spalten innerhalb eines table, grid oder treegrid.

ARIA: aria-colindextext Attribut

Das aria-colindextext Attribut definiert einen menschenlesbaren Text als Alternative zum numerischen aria-colindex.

ARIA: aria-colspan-Attribut

Das Attribut aria-colspan definiert die Anzahl der Spalten, über die sich eine Zelle oder gridcell innerhalb einer table, eines grid oder eines treegrid erstreckt.

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-details identifiziert 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.

ARIA: aria-hidden-Attribut

Der Zustand aria-hidden gibt an, ob ein Element über eine Barrierefreiheits-API zugänglich ist.

ARIA: aria-keyshortcuts-Attribut

Das globale Attribut aria-keyshortcuts gibt Tastenkombinationen an, die ein Autor implementiert hat, um ein Element zu aktivieren oder ihm den Fokus zu geben.

ARIA: aria-label Attribut

Das aria-label Attribut 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-level Attribut 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-modal gibt an, ob ein Element bei seiner Anzeige modal ist.

ARIA: aria-multiline Attribut

Das aria-multiline Attribut gibt an, ob ein textbox mehrere 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-posinset Attribut 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-readonly gibt an, dass das Element nicht bearbeitbar, aber ansonsten bedienbar ist.

ARIA: aria-relevant Attribut

Verwendet in ARIA-Live-Regionen zeigt das globale aria-relevant Attribut 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-required gibt an, dass für ein Element eine Benutzereingabe erforderlich ist, bevor ein Formular abgeschickt werden kann.

ARIA: aria-roledescription-Attribut

Das Attribut aria-roledescription definiert eine menschenlesbare, vom Autor lokalisierte Beschreibung für die Rolle eines Elements.

ARIA: aria-rowindex-Attribut

Das Attribut aria-rowindex definiert 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-rowindextext Attribut definiert eine menschenlesbare Textalternative zu aria-rowindex.

ARIA: aria-rowspan Attribut

Das aria-rowspan Attribut 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-selected gibt den aktuellen Auswahlzustand verschiedener Widgets an.

ARIA: aria-setsize-Attribut

Das Attribut aria-setsize definiert 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-valuemax definiert den maximal zulässigen Wert für ein Bereichs-Widget.

ARIA: aria-valuemin Attribut

Das aria-valuemin Attribut definiert den minimal erlaubten Wert für ein Bereichs-Widget.

ARIA: aria-valuenow-Attribut

Das Attribut aria-valuenow definiert den aktuellen Wert eines range-Widgets.

ARIA: aria-valuetext-Attribut

Das aria-valuetext-Attribut definiert den menschenlesbaren Text als Alternative zu aria-valuenow für ein Bereichs-Widget.

ARIA: Attribut aria-controls

Die globale Eigenschaft aria-controls identifiziert 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 null gesetzter Zustand von aria-current an 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-describedby gibt das Element (oder die Elemente) an, das das Element beschreibt, auf dem das Attribut gesetzt ist.

ARIA: Attribut aria-errormessage

Das Attribut aria-errormessage eines Objekts gibt das Element oder die Elemente an, die eine Fehlermeldung für dieses Objekt bereitstellen.

ARIA: Attribut aria-expanded

Das Attribut aria-expanded wird 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-invalid gibt an, dass der eingegebene Wert nicht dem von der Anwendung erwarteten Format entspricht.

ARIA: Attribut aria-multiselectable

Das Attribut aria-multiselectable gibt an, dass Benutzer mehr als ein Element aus den aktuell auswählbaren Nachfahren auswählen können.

ARIA: Attribut aria-pressed

Das Attribut aria-pressed gibt den aktuellen "gedrückten" Zustand eines Umschaltknopfs an.

ARIA: Attribut aria-rowcount

Das Attribut aria-rowcount definiert die Gesamtzahl der Zeilen in einer Tabelle, einem Grid oder einem Treegrid.

ARIA: Attribut aria-sort

Das Attribut aria-sort gibt an, ob Elemente in einer Tabelle oder einem Grid aufsteigend oder absteigend sortiert sind.

Siehe auch