ARIA: log Rolle

Ein Log ist eine Art von Live-Region, in der neue Informationen in einer sinnvollen Reihenfolge hinzugefügt werden und alte Informationen verschwinden können. Beispiele hierfür sind Chat-Logs, Nachrichtenverläufe, Spielprotokolle oder Fehlerprotokolle. Im Gegensatz zu anderen Live-Regionen gibt es bei dieser Rolle eine Beziehung zwischen dem Eintreffen neuer Elemente im Log und der Lesereihenfolge. Das Log enthält eine sinnvolle Sequenz und neue Informationen werden nur am Ende des Logs hinzugefügt, nicht an beliebigen Stellen.

Im Gegensatz zu anderen Typen von Live-Regionen ist ein Log sequentiell geordnet und neue Informationen werden nur am Ende des Logs hinzugefügt. Wenn diese Rolle zu einem Element hinzugefügt wird, sendet der Browser ein zugängliches Log-Ereignis an unterstützende Technologien, die den Nutzer darüber informieren können.

Standardmäßig enthalten Updates nur die Änderungen der Live-Region, und diese werden angekündigt, wenn der Nutzer inaktiv ist. Elemente mit der Rolle log haben einen impliziten aria-live-Wert von polite. Wenn der Nutzer die gesamte Live-Region bei einer Änderung hören muss, sollte aria-atomic="true" gesetzt werden. Um Ansagen schneller zu machen und bei Bedarf den Nutzer zu unterbrechen, kann aria-live="assertive" für aggressivere Updates gesetzt werden.

aria-atomic

Definiert, ob unterstützende Technologien die gesamte oder nur Teile der geänderten Region präsentieren sollen. Elemente mit der Rolle log haben einen impliziten aria-atomic-Wert von false.

aria-live

Definiert, wann unterstützende Technologien den Nutzer über Updates des Inhalts informieren sollen. Elemente mit der Rolle log haben einen impliziten aria-live-Wert von polite, was bedeutet, dass Screenreader Änderungen innerhalb des Logs ankündigen, wenn der Nutzer inaktiv ist.

aria-label und aria-labelledby

Das log ist erforderlich, einen zugänglichen Namen zu haben. Verwenden Sie aria-labelledby, wenn ein sichtbares Label vorhanden ist, andernfalls verwenden Sie aria-label.

Bei einem Bereich mit scrollendem Text, wie einem Börsenticker, sollte stattdessen die marquee-Rolle verwendet werden.

• ARIA: alert Rolle
• ARIA: marquee Rolle
• ARIA: status Rolle
• ARIA: timer Rolle
• ARIA Live-Regionen