Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / HTML

aria-live — announce changed content

`aria-live` indicates how urgently assistive technology should present changes to a region.

Version: WAI-ARIA 1.2

Syntax

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

Use polite for routine updates, assertive sparingly for urgent messages, and off to suppress ordinary background announcements. The last value does not guarantee silence when focus is inside the region.

Establish the region before updating its contents. Do not move focus to a message unnecessarily. Urgency is a hint to assistive technology, not a guarantee of speech order or timing; announcement scope and update grouping are separate concerns.

The example updates an existing region after Save is activated. The test confirms Settings saved. and live semantics in the accessibility tree. It does not simulate a particular screen reader, so it promises no identical announcement across configurations.

Examples

<!doctype html><meta charset="utf-8">
<button id="save">Save</button><p id="status" aria-live="polite"></p>
<output id="result"></output>
<script>
document.querySelector('#save').addEventListener('click', () => { document.querySelector('#status').textContent = 'Settings saved.'; });
document.querySelector('#save').click();
document.querySelector('#result').textContent = 'message=' + document.querySelector('#status').textContent;
</script>

Result

message=Settings saved.

Verified changed content and region semantics. Actual speech ordering needs a separate screen-reader test.

Sources