Zum Inhalt springen
Dokumentation

Komponenten

Aufklappbereich (Collapsible)

Stabil

Ein 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 DropdownMenu oder Popover gedacht – 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").

Beispiel und Quelltext
uebergabe.tsx
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.

18 von 24 Betten sind belegt, drei Entlassungen sind für heute geplant.
Beispiel und Quelltext
gesteuert.tsx
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

  • CollapsibleTrigger rendert ein natives button-Element. Enter und Leertaste schalten den Bereich um; das ist im Komponententest abgesichert.
  • Der Auslöser trägt aria-expanded="false" im geschlossenen und aria-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-label an die Schaltfläche.
  • Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Collapsible
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von CollapsibleTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch