CKTIS / HTML
aria-busy — un aggiornamento non è ancora completo
`aria-busy="true"` informa le tecnologie assistive che le modifiche di una regione sono incomplete e possono essere presentate più tardi.
Versione: WAI-ARIA 1.2
Sintassi
<div aria-live="polite" aria-busy="true">Updating…</div>Imposta la stringa true prima di più modifiche e false al termine. Il valore predefinito è false. Un lettore può rinviare la presentazione e trattare l’aggiornamento completo come un’unità. Non è garantito un momento preciso di lettura.
L’attributo non blocca clic, disabilita pulsanti, avvia download o disegna avanzamenti. Servono logica e riscontro visibile separati. Non lasciare occupata la regione dopo un errore: nel codice asincrono ripristina lo stato in finally e comunica il problema.
L’esempio registra false → true → false durante la modifica di un contatore. Il pulsante resta attivo e mostra il limite di ARIA. Se un widget perde temporaneamente elementi posseduti obbligatori durante la ricostruzione, lo stato occupato può indicare quel periodo.
Esempi
<!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>Risultato
false -> true -> false; region=3 items; buttonDisabled=false
Si controllano ordine degli stati, contenuto finale e assenza di disabilitazione automatica, non la coda vocale del lettore.