CKTIS / HTML
aria-expanded — estado expandido ou recolhido
`aria-expanded` informa se o conteúdo controlado está expandido e deve corresponder ao estado real da interface.
Versão: WAI-ARIA 1.2
Sintaxe
<button aria-expanded="false" aria-controls="panel">Details</button>No botão de expansão, define as cadeias true ou false. A ausência do estado significa que o elemento não declara capacidade de expansão. Não atribuas um estado recolhido a todas as folhas de uma árvore.
Coloca o atributo no controlo, não apenas no painel revelado. O destino pode ser indicado através de aria-controls. Alterar apenas o estado não mostra conteúdo nem fornece comportamento de clique, teclado ou foco.
O exemplo liga um botão nativo a um painel oculto. Uma função atualiza visibilidade e estado em conjunto, evitando divergências após a ativação. O teste verifica o painel visível e o estado expandido na árvore de acessibilidade. Outra ativação usa a mesma função para o recolher.
Exemplos
<!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>Resultado
expanded=true; visible=true
O resultado confirma a abertura real do painel com semântica de acessibilidade correspondente.