liveBook · Manning

Aria-live

As explained in Architecting Accessibility

aria-live is an ARIA attribute that specifies how updates to a live region should be announced by assistive technologies.

When a page changes content away from a screen reader user’s current focus, they may not know it changed. An aria-live region lets assistive technologies announce dynamic updates, helping people follow important task feedback. section 6.1.7

<div aria-live="polite">
</div>

Place the live-region container in the DOM before adding content so the browser can register it and monitor changes. section 6.1.7

Choose a priority that fits the update. Polite waits until current announcements finish; assertive interrupts them; off may announce changes when focus is inside the region. The status role implies polite, while alert implies assertive. Reserve alerts for urgent information: frequent or minor announcements can create audio clutter. section 3.4.4 section 6.1.7

Choose meaningful updates

Announce “File uploaded” or that additional form fields have appeared. For a progress bar, avoid announcing every small percentage change; for an important payment or booking, consider a confirmation page with the outcome and next step instead of only a temporary success message. section 3.4.4 section 6.1.7

How Architecting Accessibility covers it

How deep it goes
Traces setup, priority choices, and the browser-to-screen-reader announcement path, while warning against overuse.
Examples
Uses file-upload feedback, revealed form fields, progress changes, and payment or booking confirmations.
What it assumes
Explains why screen-reader users may miss dynamic changes elsewhere and how live regions can announce them.
What you can do after
Apply it by registering a live-region container before updates and choosing a priority suited to their urgency.
How it connects
Connects live regions to screen readers, the accessibility tree, and the status and alert roles.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Architecting Accessibility. The section links point to the parts of the book it draws on.