Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

aria-live — anunciar cambios de contenido

`aria-live` indica con qué urgencia las tecnologías de apoyo deben presentar los cambios de una región.

Versión: WAI-ARIA 1.2

Sintaxis

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

Usa polite para actualizaciones habituales, assertive con moderación para avisos urgentes y off para suprimir los anuncios ordinarios en segundo plano. Este último valor no garantiza silencio cuando el foco está dentro de la región.

Prepara la región antes de actualizar su contenido. No lleves el foco a un aviso innecesariamente. La urgencia orienta a las tecnologías de apoyo, pero no garantiza el orden ni el momento de la voz; el alcance del anuncio y la agrupación de cambios son cuestiones distintas.

El ejemplo actualiza una región existente tras activar Save. La prueba confirma Settings saved. y la semántica live en el árbol de accesibilidad. No simula un lector concreto, por lo que no promete un anuncio idéntico en todas las configuraciones.

Ejemplos

<!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>

Resultado

message=Settings saved.

Se verificaron el contenido modificado y la semántica de la región. El orden real de la voz requiere una prueba independiente con un lector de pantalla.

Fuentes