aria-atomic

In ARIA-Live-Regionen gibt das globale aria-atomic-Attribut an, ob unterstützende Technologien wie ein Screenreader den gesamten oder nur Teile des geänderten Bereichs basierend auf den durch das aria-relevant-Attribut definierten Änderungsbenachrichtigungen präsentieren.

Beschreibung

Live-Regionen sind Abschnitte einer Webseite, die aktualisiert werden, sei es durch Benutzerinteraktion oder nicht, während der Benutzerfokus woanders ist. Da sie außerhalb des Benutzerfokus aktualisiert werden, können unterstützende Technologien wie Screenreader das Update möglicherweise nicht "sehen", um es dem Benutzer zu melden. WAI-ARIA hat vier Eigenschaften, die es dem Entwickler ermöglichen, diese Live-Regionen zu identifizieren und der unterstützenden Technologie mitzuteilen, wie sie zu verarbeiten sind, einschließlich aria-live, aria-relevant, aria-busy und aria-atomic.

Wenn sich der Inhalt einer Live-Region ändert, wird der DOM vom geänderten Element durch seine Vorfahren durchsucht, um das erste Element mit gesetztem aria-atomic zu finden. Dies bestimmt den Inhalt, der dem Benutzer präsentiert werden soll.

Wenn kein Vorfahre explizit aria-atomic gesetzt hat, werden nur der oder die geänderten Knoten von Live-Region-Inhalten gelesen. Der Unterschied zwischen dem vollständigen Weglassen von aria-atomic und dem expliziten Setzen eines ARIA-Live-Region-Vorfahrenknotens mit aria-atomic="false" besteht darin, dass durch das explizite Setzen von aria-atomic="false" der Screenreader daran gehindert wird, die Vorfahrenkette nach oben zu gehen. Beide führen dazu, dass nur der aktualisierte Knoten gelesen wird. Wenn aria-atomic="true" gesetzt ist, wird der gesamte geänderte Bereich als Ganzes präsentiert, einschließlich des aktualisierten Knotens label, falls vorhanden.

Werte

false (Standard)

präsentiert nur den oder die geänderten Knoten.

true

präsentiert den gesamten geänderten Bereich als Ganzes, einschließlich des vom Autor definierten Labels, falls eins existiert.

Zugehörige Rollen

Wird in ALLEN Rollen verwendet.

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-atomic

Siehe auch