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>