aria-atomic attribute | ariaAtomic property

Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.

Internet Explorer 10



<element aria-atomic="true|false" ... />

Property values

Type: DOMString

A value that specifies how to present change notifications.


Present the region as a whole when changes are detected.


Default. Present only the changed regions.

Standards information


Used in Roles
No role required.


When the content of a live region changes, the change is presented to the user based on the following rules:

  • If no ancestor nodes have explicitly set aria-atomic, assistive technologies will present only the changed node to the user.
  • If aria-atomic is explicitly set to false, assistive technologies stop searching up the ancestor chain and present only the changed node.
  • If aria-atomic is explicitly set to true, assistive technologies will present the entire contents of the element.

See also

Accessible Rich Internet Applications (ARIA)