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

CKTIS / HTML

aria-busy — una actualización sigue en curso

`aria-busy="true"` informa a las tecnologías de apoyo de que los cambios de una región están incompletos y pueden presentarse después.

Versión: WAI-ARIA 1.2

Sintaxis

<div aria-live="polite" aria-busy="true">Updating…</div>

Asigna la cadena true antes de varios cambios y false al terminarlos. El valor predeterminado es false. Un lector puede posponer los cambios y presentar la actualización terminada como una unidad. No se garantiza un instante preciso de lectura.

No bloquea clics, desactiva botones, inicia descargas ni dibuja progreso. Eso requiere lógica e información visible propias. No dejes la región ocupada tras un error: en código asíncrono restablece el estado en finally e informa del fallo.

El ejemplo registra false → true → false mientras actualiza un contador. El botón sigue activo, mostrando el límite de ARIA. Si un widget pierde temporalmente elementos propios obligatorios durante su reconstrucción, el estado ocupado puede señalar ese intervalo.

Ejemplos

<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-busy="false"><span>0</span> items</div>
<button id="control">Available action</button><output id="result"></output>
<script>
const status = document.querySelector('#status');
const states = [status.getAttribute('aria-busy')];
status.setAttribute('aria-busy', 'true');
states.push(status.getAttribute('aria-busy'));
try {
  status.querySelector('span').textContent = '3';
} finally {
  status.setAttribute('aria-busy', 'false');
  states.push(status.getAttribute('aria-busy'));
}
document.querySelector('#result').textContent =
  states.join(' -> ') + '; region=' + status.textContent +
  '; buttonDisabled=' + document.querySelector('button').disabled;
</script>

Resultado

false -> true -> false; region=3 items; buttonDisabled=false

Se comprueban el orden de estados, contenido final y ausencia de desactivación automática, no la cola de voz del lector.

Fuentes