CKTIS / HTML
aria-expanded — aufgeklappter oder zugeklappter Zustand
`aria-expanded` meldet, ob gesteuerter Inhalt aufgeklappt ist, und muss dem tatsächlichen Oberflächenzustand entsprechen.
Version: WAI-ARIA 1.2
Syntax
<button aria-expanded="false" aria-controls="panel">Details</button>Setze auf dem Aufklappbutton die Zeichenfolge true oder false. Ohne Zustandsangabe erklärt das Element keine Aufklappbarkeit. Gib nicht jedem Blattelement eines Baums einen zugeklappten Zustand.
Das Attribut gehört auf das steuernde Element, nicht nur auf den angezeigten Bereich. Das Ziel kann mit aria-controls angegeben werden. Eine Zustandsänderung allein zeigt keinen Inhalt und liefert weder Klick- noch Tastatur- oder Fokusverhalten.
Das Beispiel verbindet einen nativen Button mit einem verborgenen Bereich. Eine Funktion aktualisiert Sichtbarkeit und Zustand gemeinsam, sodass sie nach der Aktivierung übereinstimmen. Der Test prüft den sichtbaren Bereich und den aufgeklappten Zustand im Barrierefreiheitsbaum. Eine erneute Aktivierung klappt ihn mit derselben Funktion zu.
Beispiele
<!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>Ergebnis
expanded=true; visible=true
Das Ergebnis bestätigt das tatsächliche Öffnen des Bereichs mit übereinstimmender Barrierefreiheitssemantik.