KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-expanded — uitgeklapte of ingeklapte toestand

`aria-expanded` meldt of bestuurde inhoud is uitgeklapt en moet overeenkomen met de werkelijke interfacetoestand.

Versie: WAI-ARIA 1.2

Syntax

<button aria-expanded="false" aria-controls="panel">Details</button>

Zet op de uitklapknop de tekenreeks true of false. Zonder toestand verklaart het element geen uitklapbaarheid. Geef niet elk bladelement van een boom een ingeklapte toestand.

Plaats het attribuut op het bedieningselement, niet alleen op het getoonde paneel. Het doel kan met aria-controls worden aangeduid. Alleen de toestand veranderen toont geen inhoud en levert geen klik-, toetsenbord- of focusgedrag.

Het voorbeeld verbindt een native knop met een verborgen paneel. Eén functie werkt zichtbaarheid en toestand samen bij, zodat ze na activering niet uiteenlopen. De test controleert het zichtbare paneel en de uitgeklapte toestand in de toegankelijkheidsboom. Nogmaals activeren klapt het met dezelfde functie in.

Voorbeelden

<!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>

Resultaat

expanded=true; visible=true

Het resultaat bevestigt dat het paneel echt opent met bijpassende toegankelijkheidssemantiek.

Bronnen