ARIA: log role

Thelog role is used to identify an element that creates alive region where new information is added in a meaningful order and old information may disappear.

Description

A log is a type of live region where new information is added in meaningful order and old information may disappear. Examples include chat logs, messaging history, game log, or an error log. In contrast to other live regions, in this role there is a relationship between the arrival of new items in the log and the reading order. The log contains a meaningful sequence and new information is added only to the end of the log, not at arbitrary points.

In contrast to other types of live region, a log is sequentially ordered and new information is only added to the end of the log. When this role is added to an element, the browser will send out an accessible log event to assistive technology products which can then notify the user about it.

By default, updates contain only the changes to the live region and these are announced when the user is idle. Elements with the rolelog have an implicitaria-live value ofpolite. Where the user needs to hear the entire live region upon a changearia-atomic="true" should be set. To have announcements made as soon as possible and where the user may be interrupted,aria-live="assertive" can be set for more aggressive updates.

Associated WAI-ARIA roles, states, and properties

aria-atomic: Defines whether assistive technologies should present all, or only parts of, the changed region. Elements with the rolelog have an implicitaria-atomic value offalse.
aria-live: Defines when assistive technology should inform the user of updates to content. Elements with the rolelog have an implicitaria-live value ofpolite, meaning screen readers will announce changes inside the log when the user is idle.
aria-label andaria-labelledby: Thelog is required to have an accessible name. Usearia-labelledby if a visible label is present, otherwise usearia-label.