Skip to content

Find what you need, instantly

Search components, ARIA roles & attributes, and WCAG criteria.

All attributes

aria-atomic

Boolean

Controls how much of a live region assistive technologies present when it changes: 'true' re-announces the whole region, 'false' (the default) announces only the nodes that changed. Set it to true when the changed value only makes sense in full context, like 'Page 3 of 8'. It works alongside aria-live and aria-relevant to shape announcements.

Values
true
Assistive tech presents the entire live region on any change.
false (default)
Assistive tech presents only the changed nodes.
Used on
Any HTML element, aria-atomic is a global property.
Associated roles
Every ARIA role. As a global property, aria-atomic is supported on all roles.
Example
aria-atomic="…"
<div aria-live="polite" aria-atomic="true">Page 3 of 8</div>