aria-atomic
In ARIA-Live-Bereichen gibt das globale aria-atomic
-Attribut an, ob unterstützende Technologien wie ein Screenreader die gesamte oder nur Teile der geänderten Region basierend auf den durch das aria-relevant
Attribut definierten Änderungsbenachrichtigungen präsentieren.
Beschreibung
Live-Bereiche sind Abschnitte einer Webseite, die aktualisiert werden, sei es durch Benutzerinteraktion oder nicht, wenn der Fokus des Benutzers woanders liegt. 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 verfügt über 4 Eigenschaften, mit denen der Entwickler diese Live-Bereiche identifizieren und der unterstützenden Technologie mitteilen kann, wie sie verarbeitet werden sollen, einschließlich aria-live
, aria-relevant
, aria-busy
und aria-atomic
.
Wenn sich der Inhalt eines Live-Bereichs ändert, wird der DOM von dem 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 aria-atomic
explizit gesetzt hat, werden nur die aktualisierten Nodes des Live-Bereichsinhalts vorgelesen. Der Unterschied zwischen dem vollständigen Weglassen von aria-atomic
und dem expliziten Setzen eines ARIA-Live-Bereich-Vorfahren-Nodes mit aria-atomic="false"
besteht darin, dass durch das explizite Setzen von aria-atomic="false"
der Screenreader daran gehindert wird, die Vorfahren-Kette nach oben zu durchlaufen. Beide führen dazu, dass nur der aktualisierte Node gelesen wird. Wenn auf aria-atomic="true"
gesetzt, wird die gesamte geänderte Region als Ganzes präsentiert, einschließlich des aktualisierten Nodes label
, falls vorhanden.
Werte
false
(Standard)-
präsentiert nur den oder die geänderten Nodes.
true
-
präsentiert die gesamte geänderte Region als Ganzes, einschließlich des vom Autor definierten Labels, falls vorhanden.
Zugehörige Rollen
Wird in ALLEN Rollen verwendet.
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-atomic |