CKTIS / HTML
aria-expanded — razširjeno ali strnjeno stanje
`aria-expanded` sporoča, ali je upravljana vsebina razširjena, in mora ustrezati dejanskemu stanju vmesnika.
Različica: WAI-ARIA 1.2
Sintaksa
<button aria-expanded="false" aria-controls="panel">Details</button>Na gumbu za razširjanje nastavi niza true ali false. Odsotnost pomeni, da element ne napoveduje možnosti razširitve. Strnjenega stanja ne dodajaj vsakemu listu drevesa.
Atribut postavi na upravljalni element, ne le na razkrito podokno. Cilj lahko določi aria-controls. Sprememba stanja sama ne pokaže vsebine in ne doda klika, tipkovnice ali upravljanja fokusa.
Primer poveže vgrajen gumb s skritim podoknom. Ena funkcija hkrati posodobi vidnost in stanje, da se po aktivaciji ne razhajata. Test preveri vidno podokno in razširjeno stanje v drevesu dostopnosti. Naslednja aktivacija z isto funkcijo vsebino strne.
Primeri
<!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>Rezultat
expanded=true; visible=true
Rezultat potrdi dejansko odprtje podokna in skladno semantiko dostopnosti.