ARIA-Zustände und -Eigenschaften (Attribute)

Diese Seite listet Referenzseiten auf, die alle auf MDN besprochenenWAI-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:

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 Eigenschaftenaria-label undaria-labelledby, die nicht auf Elemente mit der Rollepresentation oder ihrem Synonymnone angewendet werden dürfen.

Index der Zustände und Eigenschaften

Die folgenden sind die Referenzseiten, die die aufWAI-ARIA-Zustände und Eigenschaften auf MDN beschreiben.

ARIA: aria-activedescendant Attribut: Dasaria-activedescendant Attribut identifiziert das derzeit aktive Element, wenn der Fokus auf einemcomposite Widget,combobox,textbox,group oderapplication liegt.
ARIA: aria-atomic Attribut: In ARIA Live-Regionen gibt das globalearia-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 dasaria-relevant Attribut definiert sind.
ARIA: aria-autocomplete Attribut: Dasaria-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 einecombobox,searchbox odertextbox auslösen könnte und wie Vorhersagen präsentiert werden, falls sie getroffen werden.
ARIA: aria-braillelabel Attribut: Das globalearia-braillelabel Attribut definiert einen Zeichenfolgenwert, der das aktuelle Element kennzeichnet und in Braille umgewandelt werden soll.
ARIA: aria-brailleroledescription-Attribut: Das globalearia-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: Dasaria-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-busy häufig inARIA-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: Dasaria-checked Attribut gibt den aktuellen "checked"-Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets an.
ARIA: aria-colcount-Attribut: Dasaria-colcount-Attribut definiert die Gesamtanzahl der Spalten in einertable,grid odertreegrid, wenn nicht alle Spalten imDOM vorhanden sind.
ARIA: aria-colindex Attribut: Dasaria-colindex Attribut definiert den Spaltenindex oder die Position eines Elements in Bezug auf die Gesamtzahl der Spalten innerhalb einestable,grid odertreegrid.
ARIA: aria-colindextext Attribut: Dasaria-colindextext Attribut definiert einen menschenlesbaren Text als Alternative zum numerischenaria-colindex.
ARIA: aria-colspan-Attribut: Dasaria-colspan-Attribut definiert die Anzahl der Spalten, die von einer Zelle oder einem gridcell in einertable, einemgrid oder einemtreegrid überspannt werden.
ARIA: aria-controls-Attribut: Das globalearia-controls-Attribut identifiziert das Element (oder die Elemente), dessen Inhalte oder Vorhandensein durch das Element kontrolliert werden, an dem dieses Attribut gesetzt ist.
ARIA: aria-current Attribut: Ein nicht-nullaria-current Zustand auf einem Element zeigt an, dass dieses Element das aktuelle Element innerhalb eines Containers oder einer Gruppe verwandter Elemente darstellt.
ARIA: aria-describedby-Attribut: Das globalearia-describedby-Attribut identifiziert das Element (oder die Elemente), das/die das Element beschreibt/beschreiben, auf dem das Attribut gesetzt ist.
ARIA: aria-description-Attribut: Das globalearia-description-Attribut definiert einen Zeichenfolgenwert, der das aktuelle Element beschreibt oder kommentiert.
ARIA: aria-details Attribut: Das globalearia-details Attribut identifiziert das Element (oder die Elemente), die zusätzliche Informationen zu dem Objekt bereitstellen.
ARIA: aria-disabled-Attribut: Deraria-disabled-Zustand zeigt an, dass das Element wahrnehmbar, aber deaktiviert ist, sodass es nicht bearbeitbar oder anderweitig bedienbar ist.
ARIA: aria-dropeffect-Attribut: Das globalearia-dropeffect-Attribut zeigt an, welche Funktionen ausgeführt werden können, wenn ein gezogenes Objekt auf dem Ziel abgelegt wird.
ARIA: aria-errormessage Attribut: Dasaria-errormessage Attribut an einem Objekt identifiziert das bzw. die Elemente, die eine Fehlermeldung für dieses Objekt bereitstellen.
ARIA: aria-expanded Attribut: Dasaria-expanded Attribut wird auf ein Element gesetzt, um anzuzeigen, ob ein Steuerelement erweitert oder eingeklappt ist und ob die kontrollierten Elemente angezeigt oder ausgeblendet sind.
ARIA: aria-flowto-Attribut: Das globalearia-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: Deraria-grabbed-Zustand zeigt den "gegriffenen" Zustand eines Elements in einer Drag-and-Drop-Operation an.
ARIA: aria-haspopup-Attribut: Dasaria-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: Deraria-hidden Zustand gibt an, ob das Element für eine Barrierefreiheits-API zugänglich ist.
ARIA: aria-invalid Attribut: Deraria-invalid Zustand zeigt an, dass der eingegebene Wert nicht dem vom Programm erwarteten Format entspricht.
ARIA: aria-keyshortcuts-Attribut: Das globalearia-keyshortcuts-Attribut gibt Tastenkombinationen an, die ein Autor implementiert hat, um ein Element zu aktivieren oder den Fokus darauf zu setzen.
ARIA: aria-label Attribut: Dasaria-label Attribut definiert einen Zeichenfolgewert, der verwendet werden kann, um ein Element zu benennen, solange die Rolle des Elements das Benennen nichtuntersagt.
ARIA: aria-labelledby-Attribut: Dasaria-labelledby-Attribut identifiziert das Element (oder die Elemente), das das Element beschriftet, auf das es angewendet wird.
ARIA: aria-level Attribut: Dasaria-level Attribut definiert die hierarchische Ebene eines Elements innerhalb einer Struktur.
ARIA: aria-live-Attribut: Das globalearia-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: Dasaria-modal-Attribut gibt an, ob ein Element modal angezeigt wird.
ARIA: aria-multiline Attribut: Dasaria-multiline Attribut zeigt an, ob eintextbox mehrere Zeilen Eingabe akzeptiert oder nur eine einzelne Zeile.
ARIA: aria-multiselectable-Attribut: Dasaria-multiselectable-Attribut gibt an, dass der Benutzer mehr als ein Element aus den aktuellen auswählbaren Nachkommen auswählen kann.
ARIA: aria-orientation-Attribut: Dasaria-orientation-Attribut gibt an, ob die Orientierung des Elements horizontal, vertikal oder unbekannt/mehrdeutig ist.
ARIA: aria-owns-Attribut: Dasaria-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: Dasaria-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: Dasaria-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: Dasaria-readonly-Attribut gibt an, dass das Element nicht bearbeitbar ist, aber dennoch bedienbar bleibt.
ARIA: aria-relevant Attribut: Verwendet in ARIA-Live-Regionen zeigt das globalearia-relevant Attribut an, welche Benachrichtigungen der User-Agent auslöst, wenn der Zugänglichkeitsbaum innerhalb einer Live-Region modifiziert wird.
ARIA: aria-required Attribut: Dasaria-required Attribut gibt an, dass eine Benutzereingabe auf dem Element erforderlich ist, bevor ein Formular gesendet werden kann.
ARIA: aria-roledescription Attribut: Dasaria-roledescription Attribut definiert eine für Menschen lesbare, vom Autor lokalisierte Beschreibung für die Rolle eines Elements.
ARIA: aria-rowcount-Attribut: Dasaria-rowcount-Attribut definiert die Gesamtanzahl der Zeilen in einer Tabelle, einem Raster oder einem Baumraster.
ARIA: aria-rowindex-Attribut: Dasaria-rowindex-Attribut definiert die Position eines Elements in Bezug auf die Gesamtanzahl der Zeilen innerhalb einer Tabelle, eines Rasters oder eines Baumgitters.
ARIA: aria-rowindextext Attribut: Dasaria-rowindextext Attribut definiert eine menschenlesbare Textalternative zuaria-rowindex.
ARIA: aria-rowspan Attribut: Dasaria-rowspan Attribut definiert die Anzahl der von einer Zelle oder Gridcell innerhalb einer Tabelle, eines Grids oder Treegrids überspannten Reihen.
ARIA: aria-selected Attribut: Dasaria-selected Attribut zeigt den aktuellen "ausgewählten" Zustand verschiedener Widgets an.
ARIA: aria-setsize-Attribut: Dasaria-setsize-Attribut definiert die Anzahl der Elemente im aktuellen Satz von Listenelementen oder Baumelementen, wenn nicht alle Elemente des Satzes im DOM vorhanden sind.
ARIA: aria-sort Attribut: Dasaria-sort Attribut zeigt an, ob Elemente in einer Tabelle oder einem Raster in aufsteigender oder absteigender Reihenfolge sortiert sind.
ARIA: aria-valuemin Attribut: Dasaria-valuemin Attribut definiert den minimal erlaubten Wert für ein Bereichs-Widget.
ARIA: aria-valuenow-Attribut: Dasaria-valuenow-Attribut definiert den aktuellen Wert für einrange-Widget.
ARIA: aria-valuetext-Attribut: Dasaria-valuetext-Attribut definiert den menschenlesbaren Text als Alternative zuaria-valuenow für ein Bereichs-Widget.
ARIA: Attribut aria-pressed: Das Attributaria-pressed gibt den aktuellen "gedrückten" Zustand eines Umschaltknopfs an.
ARIA: Attribut aria-valuemax: Das Attributaria-valuemax definiert den maximal zulässigen Wert für ein Range-Widget.

Siehe auch

Verwendung von ARIA: Rollen, Zustände und Eigenschaften

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換

ARIA-Zustände und -Eigenschaften (Attribute)

ARIA-Attributtypen

Widget-Attribute

Live-Region-Attribute

Drag-and-Drop-Attribute

Beziehungs-Attribute

Globale ARIA-Attribute

Index der Zustände und Eigenschaften

Siehe auch

Help improve MDN