Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti