CKTIS / HTML
aria-expanded — rozbalený nebo sbalený stav
`aria-expanded` sděluje, zda je ovládaný obsah rozbalený, a musí odpovídat skutečnému rozhraní.
Verze: WAI-ARIA 1.2
Syntaxe
<button aria-expanded="false" aria-controls="panel">Details</button>Na rozbalovacím tlačítku nastav řetězce true nebo false. Nepřítomnost znamená, že prvek neoznamuje možnost rozbalení. Nedávej sbalený stav každému koncovému uzlu stromu.
Atribut patří ovládacímu prvku, ne pouze zobrazovanému panelu. Cíl lze označit pomocí aria-controls. Samotná změna stavu obsah nezobrazí a nepřidá obsluhu kliknutí, klávesnice či fokusu.
Příklad propojuje nativní tlačítko se skrytým panelem. Jedna funkce aktualizuje viditelnost i stav, aby se po aktivaci nerozcházely. Test kontroluje viditelný panel a rozbalení ve stromu přístupnosti. Další aktivace použije stejnou funkci ke sbalení.
Příklady
<!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>Výsledek
expanded=true; visible=true
Výsledek potvrzuje skutečné otevření panelu se souhlasnou sémantikou přístupnosti.