CKTIS / JavaScript
Regiones activas de ARIA: status, alert, aria-live y aria-atomic
Las regiones activas de ARIA comunican cambios a las tecnologías de asistencia sin mover el foco. Elige la prioridad del anuncio y cuánto contexto debe incluir.
Versión: Current web platform; runtime support varies
Sintaxis
// Live-region roles and attributes are defined by WAI-ARIA 1.2.
role="status" (implicit aria-live="polite", aria-atomic="true")
role="alert" (implicit aria-live="assertive", aria-atomic="true")
aria-live="off" | "polite" | "assertive"
aria-atomic="false" | "true"
// DOM update: change the text of a node in an existing live region.
messageNode.textContent = message;Una región activa de ARIA permite que una tecnología de asistencia, como un lector de pantalla, anuncie cambios de contenido sin mover el foco. Estos roles y atributos son de la plataforma web, no de ECMAScript. JavaScript actualiza el DOM, por ejemplo con textContent para un mensaje de texto plano.
Usa role="status" para información no urgente, como el número de resultados. Implica aria-live="polite" y aria-atomic="true". El rol role="alert" implica aria-live="assertive" y aria-atomic="true". Úsalo con moderación, solo para mensajes urgentes que no requieran respuesta. No añadas aria-live="assertive" de forma redundante a una alerta: algunas configuraciones pueden anunciarla dos veces.
aria-live establece la prioridad: polite espera una pausa adecuada, assertive puede interrumpir el anuncio en curso y off no solicita anuncios si el foco está fuera de la región. Con el foco dentro, aún pueden anunciarse los cambios. aria-atomic establece el alcance, no la prioridad: true solicita todo el contenido de la región y false solo los nodos que cambiaron. El valor general por defecto es false, pero ambos roles de arriba implican true.
Coloca una región vacía en el DOM antes de actualizar su contenido, preferiblemente en el HTML inicial. No le asignes el foco solo para anunciar un cambio. Algunas configuraciones también anuncian una alerta insertada con su texto, pero no dependas de ello. Prueba las combinaciones de navegador y tecnología de asistencia que admitas.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ARIA live regions</title>
</head>
<body>
<button type="button" id="add-result">Add result</button>
<button type="button" id="simulate-failure">Simulate connection loss</button>
<p id="result-status" role="status"></p>
<p id="connection-alert" role="alert"></p>
<script>
const statusRegion = document.getElementById('result-status');
const alertRegion = document.getElementById('connection-alert');
const count = document.createElement('span');
let total = 0;
document.getElementById('add-result').addEventListener('click', () => {
if (total === 0) statusRegion.append('Results: ', count);
total += 1;
count.textContent = String(total);
});
document.getElementById('simulate-failure').addEventListener('click', () => {
alertRegion.textContent = 'Connection lost. Changes cannot be saved.';
});
</script>
</body>
</html>Resultado
Initially both regions are empty. After the first activation of Add result: Results: 1 After the second activation of Add result: Results: 2 After activating Simulate connection loss: Connection lost. Changes cannot be saved. These are visible text updates, not a screen reader transcript.
Guarda el ejemplo como archivo HTML y ábrelo en un navegador. Activa «Add result» dos veces y después «Simulate connection loss». La segunda vez solo cambia el número, pero `status` solicita el mensaje completo. El resultado es texto visible, no una lectura garantizada.
Lecciones relacionadas
- JavaScript · Lección 23 · Intermedio · Versión: 3