CKTIS / JavaScript
Interazioni accessibili in JavaScript
Un’interazione accessibile combina l’uso da tastiera, un focus prevedibile e uno stato comprensibile alle tecnologie assistive. JavaScript dovrebbe sincronizzare la visibilità con ARIA e comunicare gli aggiornamenti senza spostare inutilmente il focus.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Un’interazione accessibile permette di usare un’interfaccia senza mouse e di comprenderne i cambiamenti con l’aiuto delle tecnologie assistive. Inizia con pulsanti nativi: forniscono semantica e attivazione da tastiera. ARIA descrive l’interfaccia, ma da sola non aggiunge comportamenti. La specifica ECMAScript descrive il linguaggio e lo distingue dal suo ambiente host; la fonte fornita non definisce DOM, HTML né ARIA.
La gestione dello stato ARIA e del focus da tastiera consiste nel sincronizzare stato, visibilità e focus. Nell’esempio, aria-expanded corrisponde al valore opposto di panel.hidden, mentre aria-controls identifica panel. Nel test di apertura, il focus è già sul pulsante Details e vi rimane; il pannello non è una finestra di dialogo modale. Il gestore di Close details sposta il focus su Details prima di nascondere il pannello. Quando Details chiude il pannello, se il focus è ancora al suo interno, setExpanded lo riporta su Details prima di nascondere il pannello. Il test in console copre entrambe le modalità di chiusura, compresa l’attivazione di Details senza spostare prima il focus sul pulsante. Non rimuovere l’indicatore visibile del focus e non usare valori positivi di tabindex per correggere l’ordine di navigazione.
Gli annunci delle regioni live di ARIA comunicano gli aggiornamenti senza spostare il focus. L’esempio aggiorna textContent in una regione esistente con role="status". Questo ruolo fornisce implicitamente il comportamento di aria-live="polite"; nel markup non è impostato alcun attributo aria-live. L’attributo aria-atomic="true" indica che l’intero contenuto della regione va trattato come messaggio. La regione esiste prima dell’aggiornamento. Non usarla al posto delle etichette dei controlli e non annunciare ogni cambiamento minimo. Le parole esatte e il momento dell’annuncio dipendono dal browser e dalla tecnologia assistiva.
Salva l’esempio come file HTML e verifica l’uso della tastiera, i valori degli attributi e gli annunci dello screen reader. Il risultato previsto descrive lo stato del DOM e la posizione del focus, ma non garantisce ciò che dirà lo screen reader. L’esempio è stato eseguito in un ambiente isolato con Chromium e l’output della console ha coinciso esattamente con quello previsto. Usa la sintassi ECMAScript 2015 e interfacce del browser; il supporto nell’ambiente di destinazione va verificato separatamente. Node 24 nel repository non dimostra il supporto di queste interfacce.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Accessible disclosure</title>
</head>
<body>
<button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" aria-label="Details" hidden>
<p>Additional information.</p>
<button id="close" type="button">Close details</button>
</section>
<p id="status" role="status" aria-atomic="true"></p>
<script>
const toggle = document.getElementById('toggle');
const panel = document.getElementById('panel');
const closeButton = document.getElementById('close');
const statusMessage = document.getElementById('status');
function setExpanded(expanded) {
if (!expanded && panel.contains(document.activeElement)) {
toggle.focus();
}
panel.hidden = !expanded;
toggle.setAttribute('aria-expanded', String(expanded));
statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
}
toggle.addEventListener('click', () => setExpanded(panel.hidden));
closeButton.addEventListener('click', () => {
toggle.focus();
setExpanded(false);
});
function report(step) {
console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
}
report('Initial');
toggle.focus();
toggle.click();
report('Open');
console.log('Open kept focus on Details: ' + (document.activeElement === toggle));
// Test closing when activation does not first focus the close button.
toggle.blur();
console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
closeButton.click();
report('Close');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
// Test closing with Details while focus remains inside the panel.
toggle.click();
closeButton.focus();
console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
toggle.click();
report('Close with Details');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
</script>
</body>
</html>Risultato
Initial: hidden=true; aria-expanded=false; status="" Open: hidden=false; aria-expanded=true; status="Details opened." Open kept focus on Details: true Focus inside panel before close: false Close: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true Focus inside panel before closing with Details: true Close with Details: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true
Il test attiva `Details` da codice mentre il focus è su `Close details`. Il focus dovrebbe tornare su `Details` prima che il pannello venga nascosto.