Komponenten
Aufklappbereich (Collapsible)
StabilEin einzelner Bereich, der sich auf und zu klappen lässt – etwa die Hinweise zum Schichtende.
Ein Aufklappbereich zeigt einen einzelnen Inhalt erst auf Wunsch: die Hinweise zum Schichtende, die Zusatzangaben zu einem Zimmer, die Begründung einer Ablehnung. Anders als beim Akkordeon gibt es keine Gruppe von Abschnitten.
Wann verwenden
- Für einen einzelnen optionalen Inhalt, der die Hauptaussage nicht unterbrechen soll – etwa „Hinweise zum Schichtende“ unter dem Dienstplan.
- Wenn der Inhalt selten gebraucht wird, aber ohne Seitenwechsel erreichbar bleiben soll.
- Wenn eine andere Stelle im Formular den Bereich steuern soll, etwa eine Schaltfläche „Aufklappen“ in der Werkzeugleiste.
Wann nicht
- Für mehrere gleichartige Abschnitte nimm ein
Accordion; es übernimmt Ausrichtung und Tastaturführung für die Gruppe. - Für Inhalte, die im Ablauf immer gebraucht werden, ist ein zusätzlicher Klick eine Hürde. Zeige sie direkt an.
- Für Menüs und Auswahllisten sind
DropdownMenuoderPopovergedacht – sie bringen Fokusführung und Schließen bei Klick daneben mit.
Aufbau
Collapsible hält den offenen Zustand, CollapsibleTrigger ist die
Schaltfläche und CollapsibleContent der Bereich. Der Auslöser bringt keine
eigene Gestaltung mit; er lässt sich über className gestalten oder mit
asChild an einen Button übergeben. Das Symbol dreht sich über den
Zustand des Auslösers (data-state="open").
import { ChevronDown } from "lucide-react";
import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@neodin-eu/ui";
function Uebergabe() {
return (
<Collapsible className="w-full max-w-lg rounded-md border border-border">
<CollapsibleTrigger className="flex w-full items-center justify-between gap-4 px-4 py-3 text-left text-sm font-semibold text-foreground outline-none hover:underline focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background [&[data-state=open]>svg]:rotate-180">
Hinweise zum Schichtende
<ChevronDown
aria-hidden="true"
className="size-4 shrink-0 text-muted-foreground transition-transform duration-200"
/>
</CollapsibleTrigger>
<CollapsibleContent className="border-t border-border px-4 py-3 text-sm text-muted-foreground">
Prüfe vor dem Feierabend die offenen Tickets der Station 3 und trage die Bettenbelegung
nach. Die Übergabe an den Nachtdienst steht im Protokoll.
</CollapsibleContent>
</Collapsible>
);
}Von außen gesteuert
Mit open und onOpenChange liegt der Zustand außerhalb der Komponente.
So können weitere Schaltflächen denselben Bereich auf- und zuklappen – etwa
eine Aktion in der Werkzeugleiste.
import * as React from "react";
import { Button, Collapsible, CollapsibleContent, CollapsibleTrigger } from "@neodin-eu/ui";
function Gesteuert() {
const [offen, setOffen] = React.useState(true);
return (
<div className="flex w-full max-w-lg flex-col gap-3">
<Collapsible open={offen} onOpenChange={setOffen} className="rounded-md border border-border">
<CollapsibleTrigger asChild>
<Button variant="ghost" className="w-full justify-between">
Belegung der Station 3<span aria-hidden="true">{offen ? "−" : "+"}</span>
</Button>
</CollapsibleTrigger>
<CollapsibleContent className="border-t border-border px-4 py-3 text-sm text-muted-foreground">
18 von 24 Betten sind belegt, drei Entlassungen sind für heute geplant.
</CollapsibleContent>
</Collapsible>
<div className="flex gap-2">
<Button size="sm" variant="outline" onClick={() => setOffen(true)}>
Aufklappen
</Button>
<Button size="sm" variant="outline" onClick={() => setOffen(false)}>
Einklappen
</Button>
</div>
</div>
);
}Barrierefreiheit
CollapsibleTriggerrendert ein nativesbutton-Element.EnterundLeertasteschalten den Bereich um; das ist im Komponententest abgesichert.- Der Auslöser trägt
aria-expanded="false"im geschlossenen undaria-expanded="true"im offenen Zustand. Der Inhalt ist geschlossen nicht im Dokument, offen sichtbar; auch das prüft der Komponententest. - Der sichtbare Text des Auslösers ist sein zugänglicher Name. Wird nur ein
Symbol verwendet, gehört ein
aria-labelan die Schaltfläche. - Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |