# Barrierefreies Akkordeon: Buttons und Zustand

Source: https://allyway.ai/de/glossary/barrierefreies-akkordeon

Ein barrierefreies Akkordeon ist eine Gruppe aufklappbarer Abschnitte, deren Kopfzeilen Buttons in Überschriften sind, ihren Zustand mit aria-expanded melden und sich per Tastatur öffnen lassen. Selbst gebaute Akkordeons fallen unter WCAG 4.1.2 Name, Rolle, Wert auf Stufe A.

Ein barrierefreies Akkordeon lässt alle Besucher seine Abschnitte öffnen und schließen – per Maus, Tastatur oder Screenreader. Akkordeons stecken in FAQ-Seiten, Produktdetails, mobilen Menüs und Cookie-Einstellungen. Oft ist die anklickbare Kopfzeile aber ein `div` mit Klick-Handler: Tastatur-Nutzer können sie nicht öffnen, und Screenreader-Nutzer erfahren nie, dass dahinter weiterer Inhalt verborgen ist.

## Was es bedeutet

Ein per Skript gebautes Akkordeon ist eine eigene Komponente, deshalb gilt [WCAG 4.1.2 Name, Rolle, Wert](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (Stufe A): [Name, Rolle und Wert](https://allyway.ai/de/glossary/name-rolle-wert) müssen programmatisch ermittelbar sein, und Zustandsänderungen müssen assistive Technologien erreichen. Das W3C nennt Aufklapp-Widgets ausdrücklich als Beispiel. Das [Accordion Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/accordion/) der W3C ARIA Authoring Practices beschreibt den Aufbau:

| Teil | Was es braucht |
|---|---|
| Kopfzeile | Ein `button` als einziges Element in einer Überschrift (`h2`, `h3` …, passend zur [Überschriftenstruktur](https://allyway.ai/de/glossary/ueberschriftenstruktur) der Seite) |
| Zustand | `aria-expanded="true"`, wenn der Bereich sichtbar ist, `"false"`, wenn er verborgen ist |
| Verknüpfung | `aria-controls` mit der ID des Bereichs |
| Bereich (optional) | `role="region"` mit `aria-labelledby` auf seinen Button – nicht verwenden, wenn viele Bereiche gleichzeitig offen sein können (etwa mehr als 6), damit die Seite nicht mit Landmarks überladen wird |
| Bereich, der nicht schließt | `aria-disabled="true"` am Button, wenn das Akkordeon das Zuklappen eines offenen Bereichs nicht erlaubt |

Tastatur: Enter oder Leertaste öffnet bzw. schließt den Bereich der fokussierten Kopfzeile. Tab und Umschalt + Tab bewegen sich durch alle fokussierbaren Elemente, auch durch den Inhalt geöffneter Bereiche.

> **Tip:** > **Die native Lösung: details und summary**
> Für einen einzelnen aufklappbaren Abschnitt bringen die HTML-Elemente `<details>` und `<summary>` Rolle, Zustand und Tastaturbedienung bereits mit – ganz ohne ARIA. Das ARIA-Muster lohnt sich, wenn Sie das volle Akkordeon-Verhalten brauchen, etwa dass immer nur ein Bereich offen ist.

## Praxisbeispiele

```html title="Beispiel"
<h3>
  <button type="button" id="acc-1" aria-expanded="false"
          aria-controls="acc-panel-1">
    Wie lange dauert der Versand?
  </button>
</h3>
<div id="acc-panel-1" role="region" aria-labelledby="acc-1" hidden>
  <p>Bestellungen innerhalb Österreichs kommen in 2–3 Werktagen an.</p>
</div>
```

Das Skript schaltet `aria-expanded` und `hidden` immer gemeinsam um. Ein Screenreader kündigt dann etwa „Wie lange dauert der Versand?, Schalter, reduziert, Überschrift Ebene 3“ an – Nutzer wissen, was es ist, dass es sich öffnen lässt und wo es in der Gliederung steht. Weil es ein echter `<button>` ist, funktioniert die [Tastaturbedienung](https://allyway.ai/de/glossary/tastaturbedienung) ohne zusätzlichen Code.

**Do:** Do

Setzen Sie einen echten Button in eine Überschrift, halten Sie `aria-expanded` synchron mit dem, was sichtbar ist, verbergen Sie geschlossene Bereiche mit `hidden` oder `display: none` und zeigen Sie einen sichtbaren Fokusrahmen an den Kopfzeilen.

**Don't:** Don't

Ein `div` oder die Überschrift selbst anklickbar machen, den Zustand nur über ein drehendes Pfeil-Icon zeigen, Zustände wie `aria-selected` setzen, die ein Button nicht haben kann, oder geschlossene Bereiche nur optisch ausblenden, sodass Screenreader sie trotzdem vorlesen.

## So prüfen Sie ein barrierefreies Akkordeon



## Häufige Fragen

Q: Wie mache ich ein Akkordeon barrierefrei?
A: Verwenden Sie für jede Kopfzeile einen `<button>` in einer Überschrift, setzen Sie `aria-expanded` auf `true` oder `false`, verknüpfen Sie den Button über `aria-controls` mit seinem Bereich und verbergen Sie geschlossene Bereiche mit `hidden`. Die Tastatur übernimmt dann der Browser.

Q: Sind Akkordeon-Kopfzeilen Überschriften oder Buttons?
A: Beides: Das W3C-Muster setzt den Button in eine Überschrift. Über die Überschrift springen Nutzer zwischen Abschnitten, über den Button öffnen und schließen sie sie.

Q: Kann ich details und summary als Akkordeon verwenden?
A: Ja, für einfache aufklappbare Abschnitte sind `<details>` und `<summary>` von Haus aus barrierefrei. Soll immer nur ein Bereich offen sein oder brauchen Sie eigene Animationen, gibt Ihnen das ARIA-Muster mehr Kontrolle.

Q: Braucht ein Akkordeon Pfeiltasten-Navigation?
A: Sie ist nicht Pflicht. Kern des W3C-Musters sind Enter, Leertaste und Tab; das Wechseln zwischen Kopfzeilen mit Pfeiltasten ist eine optionale Ergänzung. Bei Tabs werden Pfeiltasten dagegen erwartet.

Q: Eignen sich Akkordeons für FAQ-Seiten?
A: Sie halten lange Seiten kurz, verborgene Antworten werden aber leicht übersehen. Klare Fragen als Überschriften helfen – und auf langen FAQ-Seiten die Möglichkeit, alle Abschnitte auf einmal zu öffnen.
