Zum Inhalt springen
Dokumentation

Komponenten

Akkordeon (Accordion)

Stabil

Mehrere Abschnitte untereinander – immer nur einer offen, die anderen bleiben erreichbar.

Ein Akkordeon stapelt mehrere Abschnitte übereinander und klappt jeweils einen davon auf. Die Überschriften bleiben sichtbar, der Inhalt erscheint erst auf Wunsch – etwa bei der Übergabe, beim Dienstplan und bei den Hinweisen einer Station.

Wann verwenden

  • Für mehrere kurze Abschnitte, die zusammen eine Seite füllen würden, aber nicht gleichzeitig gebraucht werden – etwa Übergabe, Dienstplan und Hinweise einer Station.
  • Wenn die Überschriften den Inhalt verraten und der Inhalt nur bei Bedarf gelesen wird.
  • Wenn immer nur ein Abschnitt offen sein soll, damit die Seite ruhig bleibt.

Wann nicht

  • Für wenige Zeilen, die ohnehin auf die Seite passen, ist Auf- und Zuklappen ein zusätzlicher Schritt. Zeige den Inhalt direkt.
  • Für Hinweise, die jede Person sehen muss, etwa eine Sperrung der Station, ist ein Alert richtig. Ein zugeklappter Abschnitt wird leicht übersehen.
  • Für die Seitennavigation sind Tabs die bessere Wahl: Sie zeigen immer genau einen Bereich und halten die Position der übrigen.

Aufbau

Accordion hält den Zustand, AccordionItem ist ein Abschnitt, AccordionTrigger die sichtbare Überschrift und AccordionContent der Inhalt. Mit type="single" und collapsible ist genau ein Abschnitt offen, und auch dieser lässt sich wieder schließen. defaultValue bestimmt, welcher Abschnitt beim Laden geöffnet ist.

Der Frühdienst übergibt die Station 3 an den Spätdienst. Offene Punkte stehen im Übergabeprotokoll.

Beispiel und Quelltext
station.tsx
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@neodin-eu/ui";

function Station() {
  return (
    <Accordion type="single" collapsible defaultValue="uebergabe" className="w-full max-w-lg">
      <AccordionItem value="uebergabe">
        <AccordionTrigger>Übergabe</AccordionTrigger>
        <AccordionContent>
          Der Frühdienst übergibt die Station 3 an den Spätdienst. Offene Punkte stehen im
          Übergabeprotokoll.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="dienstplan">
        <AccordionTrigger>Dienstplan</AccordionTrigger>
        <AccordionContent>
          Der Dienstplan für die nächste Woche ist veröffentlicht. Zwei Schichten sind noch offen.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="hinweise">
        <AccordionTrigger>Hinweise</AccordionTrigger>
        <AccordionContent>
          Die Bettenbelegung wird um 14 Uhr aktualisiert. Änderungen bitte an die Stationsleitung
          melden.
        </AccordionContent>
      </AccordionItem>
    </Accordion>
  );
}

Mehrere Abschnitte gleichzeitig

Mit type="multiple" bleiben mehrere Abschnitte offen. Das passt, wenn Zusammenfassungen nebeneinander verglichen werden – etwa offene Tickets neben der Bettenbelegung. defaultValue ist dann eine Liste von Werten.

Vier Tickets warten auf eine Rückmeldung, zwei davon sind der Station 3 zugeordnet.

18 von 24 Betten sind belegt. Zwei Aufnahmen sind für den Spätdienst angekündigt.

Beispiel und Quelltext
mehrere.tsx
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@neodin-eu/ui";

function Mehrere() {
  return (
    <Accordion type="multiple" defaultValue={["tickets", "belegung"]} className="w-full max-w-lg">
      <AccordionItem value="tickets">
        <AccordionTrigger>Offene Tickets</AccordionTrigger>
        <AccordionContent>
          Vier Tickets warten auf eine Rückmeldung, zwei davon sind der Station 3 zugeordnet.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="belegung">
        <AccordionTrigger>Bettenbelegung</AccordionTrigger>
        <AccordionContent>
          18 von 24 Betten sind belegt. Zwei Aufnahmen sind für den Spätdienst angekündigt.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="schicht">
        <AccordionTrigger>Schichtübergabe</AccordionTrigger>
        <AccordionContent>
          Die Übergabe dauert heute länger, weil ein Zimmerwechsel vorbereitet wird.
        </AccordionContent>
      </AccordionItem>
    </Accordion>
  );
}

Barrierefreiheit

  • AccordionTrigger rendert ein natives button-Element mit aria-expanded="false" im geschlossenen und aria-expanded="true" im offenen Zustand. Der Inhalt ist geschlossen nicht sichtbar und offen sichtbar; im Komponententest ist er geschlossen gar nicht im Dokument.
  • Die Pfeiltasten bewegen den Fokus zwischen den Überschriften: ArrowDown zur nächsten, ArrowUp zur vorherigen. Das ist im Komponententest abgesichert.
  • Als natives button-Element reagiert der Auslöser auf Enter und Leertaste; Radix schaltet damit den Abschnitt um.
  • Die Überschrift des Abschnitts ist der zugängliche Name des Auslösers. Ein zusätzliches aria-label ist nicht nötig und würde ihn überschreiben.
  • Der offene und der geschlossene Zustand sind im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Accordion
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
defaultValuestring | string[]–NeinThe value of the item whose content is expanded when the accordion is initially rendered. Use `defaultValue` if you do not need to control the state of an accordion. The value of the items whose contents are expanded when the accordion is initially rendered. Use `defaultValue` if you do not need to control the state of an accordion.
disabledboolean–NeinWhether or not an accordion is disabled from user interaction. @defaultValue false
onValueChange((value: string) => void) | ((value: string[]) => void)–NeinThe callback that fires when the state of the accordion changes.
valuestring | string[]–NeinThe controlled stateful value of the accordion item whose content is expanded. The controlled stateful value of the accordion items whose contents are expanded.

Der Auslöser bringt die Attribute eines nativen button-Elements mit:

Props von AccordionTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch