CKTIS / HTML
aria-expanded — stato espanso o compresso
`aria-expanded` comunica se il contenuto controllato è espanso e deve corrispondere allo stato reale dell’interfaccia.
Versione: WAI-ARIA 1.2
Sintassi
<button aria-expanded="false" aria-controls="panel">Details</button>Sul pulsante di espansione imposta le stringhe true o false. L’assenza dello stato significa che l’elemento non dichiara la possibilità di espandersi. Non assegnare lo stato compresso a ogni elemento foglia di un albero.
Metti l’attributo sul controllo, non soltanto sul pannello mostrato. La destinazione può essere indicata con aria-controls. Cambiare solo lo stato non mostra contenuti e non fornisce comportamento per clic, tastiera o focus.
L’esempio collega un pulsante nativo a un pannello nascosto. Una funzione aggiorna insieme visibilità e stato, evitando disallineamenti dopo l’attivazione. Il test verifica il pannello visibile e lo stato espanso nell’albero di accessibilità. Una nuova attivazione usa la stessa funzione per comprimerlo.
Esempi
<!doctype html><meta charset="utf-8">
<button id="toggle" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" hidden><h2>Course details</h2><p>Three short lessons.</p></section>
<output id="result"></output>
<script>
const button = document.querySelector('#toggle'), panel = document.querySelector('#panel');
button.addEventListener('click', () => {
const expanded = button.getAttribute('aria-expanded') !== 'true';
panel.hidden = !expanded;
button.setAttribute('aria-expanded', String(expanded));
});
button.click();
document.querySelector('#result').textContent = 'expanded=' + button.getAttribute('aria-expanded') + '; visible=' + !panel.hidden;
</script>Risultato
expanded=true; visible=true
Il risultato conferma l’apertura effettiva del pannello con una semantica di accessibilità coerente.