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

CKTIS / HTML

aria-atomic — presentar el mensaje cambiado completo

`aria-atomic` define si una actualización de una región viva se presenta completa o solamente mediante la parte modificada.

Versión: WAI-ARIA 1.2

Sintaxis

<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>

ARIA usa las cadenas true y false, no un booleano HTML activado por presencia. En aria-live="polite" con “Total: 2 items”, true conserva el contexto si solo cambia el número. No establece urgencia ni crea por sí solo una región viva.

Importa el atributo explícito más cercano en la cadena de ancestros. Un false explícito detiene la búsqueda; sin ajuste aplicable, el valor predeterminado es presentar la parte cambiada. Algunos roles tienen valores implícitos: status es atómico por defecto.

El ejemplo cambia solo el span y conserva el mensaje completo. Se comprobaron DOM y propiedad atómica del árbol de accesibilidad de Chromium. Eso no garantiza una frase concreta en todos los lectores, que pueden agrupar cambios. Evita regiones enormes que repitan textos largos.

Ejemplos

<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-atomic="true">Total: <span id="count">2</span> items</div>
<output id="result"></output>
<script>
document.querySelector('#count').textContent = '3';
const status = document.querySelector('#status');
document.querySelector('#result').textContent =
  'atomic=' + status.getAttribute('aria-atomic') + '; region=' + status.textContent;
</script>

Resultado

atomic=true; region=Total: 3 items

La prueba verifica semántica expuesta y contenido final. La voz real requiere probar el lector elegido.

Fuentes