Komponenten
Akkordeon (Accordion)
StabilMehrere 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
Alertrichtig. Ein zugeklappter Abschnitt wird leicht übersehen. - Für die Seitennavigation sind
Tabsdie 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.
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.
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
AccordionTriggerrendert ein nativesbutton-Element mitaria-expanded="false"im geschlossenen undaria-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:
ArrowDownzur nächsten,ArrowUpzur vorherigen. Das ist im Komponententest abgesichert. - Als natives
button-Element reagiert der Auslöser aufEnterundLeertaste; Radix schaltet damit den Abschnitt um. - Die Überschrift des Abschnitts ist der zugängliche Name des Auslösers. Ein
zusätzliches
aria-labelist 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| defaultValue | string | string[] | – | Nein | The 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. |
| disabled | boolean | – | Nein | Whether or not an accordion is disabled from user interaction. @defaultValue false |
| onValueChange | ((value: string) => void) | ((value: string[]) => void) | – | Nein | The callback that fires when the state of the accordion changes. |
| value | string | string[] | – | Nein | The 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:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |