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.

Syntax

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

Property values

Type: DOMString

A value that specifies how to present change notifications.

true

Present the region as a whole when changes are detected.

false

Default. Present only the changed regions.

Standards information

• Accessible Rich Internet Applications (WAI-ARIA) 1.0, Section 6.6

Remarks

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)

aria-relevant

Build date: 11/28/2012