Main content



Superclass Role:

  • region

See Related:

  • marquee

Inherited States and Properties:

  • aria-atomic
  • aria-busy (state)
  • aria-controls
  • aria-describedby
  • aria-disabled (state)
  • aria-dropeffect
  • aria-expanded (state)
  • aria-flowto
  • aria-grabbed (state)
  • aria-haspopup
  • aria-hidden (state)
  • aria-invalid (state)
  • aria-label
  • aria-labelledby
  • aria-live
  • aria-owns
  • aria-relevant

Name From:

  • author

Accessible Name Required:

  • True

Implicit Value for Role:

  • Default for aria-live is polite.

A type of live region where new information is added in meaningful order and old information may disappear.

In a live region of the page where new content is added and the added content is intimated to the user the log (role) is used. Usually in applications such as chat widgets, the new message that arrives should be intimated to the user. This should follow a sequential order.

Elements with the role log have an implicit aria-live value of polite. However if the updated content should be intimated to the user interrupting the existing work aria-live can be set to assertive. When entire live region should be intimated to the user set aria-atomic="true".

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.

Microsoft Active Accessibility accRole Property: 


UI Automation ControlType Property: 

  • Pane

UI Automation AriaRole Property: 

  • log
More in this category: « main listitem »