Zum Inhalt springen
Dokumentation

Komponenten

Schublade (Drawer)

Stabil

Kurze Details von unten – für Tablet und Telefon, mit einer klaren Aktion am unteren Rand.

Die Schublade kommt von unten und eignet sich für kurze Details auf dem Tablet oder Telefon: Schichtdetails, ein Ticket oder eine Bestätigung. Auf großen Bildschirmen ist ein Seitenpanel meist die bessere Wahl.

Wann verwenden

  • Auf Tablet und Telefon für Details, die die Liste nicht verlassen sollen.
  • Für eine kurze Zusammenfassung mit einer klaren Aktion am unteren Rand.
  • Wenn die Bewegung von unten zum Kontext passt, etwa bei einer Karte in einer Liste.

Wann nicht

  • Auf breiten Bildschirmen wirkt eine Schublade schnell wie ein Fremdkörper; nimm ein Seitenpanel.
  • Für Formulare mit vielen Feldern ist ein Dialog oder eine eigene Seite ruhiger.
  • Für eine Entscheidung mit Folgen braucht es den Bestätigungsdialog.

Schichtdetails

Drawer hält den Zustand, DrawerTrigger öffnet, DrawerContent zeigt den Inhalt. Den Griff am oberen Rand bringt DrawerContent selbst mit, Titel und Beschreibung kommen aus DrawerTitle und DrawerDescription. Aktionen stehen in DrawerFooter, ein DrawerClose schließt die Schublade.

Beispiel und Quelltext
schicht.tsx
import {
  Button,
  Drawer,
  DrawerClose,
  DrawerContent,
  DrawerDescription,
  DrawerFooter,
  DrawerHeader,
  DrawerTitle,
  DrawerTrigger,
} from "@neodin-eu/ui";

function Schicht() {
  return (
    <Drawer>
      <DrawerTrigger asChild>
        <Button variant="secondary">Schichtdetails</Button>
      </DrawerTrigger>
      <DrawerContent>
        <DrawerHeader>
          <DrawerTitle>Frühschicht, Station 3</DrawerTitle>
          <DrawerDescription>
            06:00 bis 14:00, zwei Übergaben und eine offene Materialbestellung.
          </DrawerDescription>
        </DrawerHeader>
        <div className="px-4 text-sm">
          <p>
            Das Team ist vollständig besetzt. Die Bestellung für Verbandsmaterial ist noch nicht
            bestätigt.
          </p>
        </div>
        <DrawerFooter>
          <DrawerClose asChild>
            <Button variant="outline">Schließen</Button>
          </DrawerClose>
        </DrawerFooter>
      </DrawerContent>
    </Drawer>
  );
}

Ticketdetails

Auch kurze Statusangaben passen in die Schublade: ein Ticket mit Stand und nächstem Schritt. Der Inhalt bleibt knapp, damit die Schublade nicht zur eigenen Seite wird.

Beispiel und Quelltext
ticket.tsx
import {
  Badge,
  Button,
  Drawer,
  DrawerClose,
  DrawerContent,
  DrawerDescription,
  DrawerFooter,
  DrawerHeader,
  DrawerTitle,
  DrawerTrigger,
} from "@neodin-eu/ui";

function Ticket() {
  return (
    <Drawer>
      <DrawerTrigger asChild>
        <Button variant="outline">Ticket ansehen</Button>
      </DrawerTrigger>
      <DrawerContent>
        <DrawerHeader>
          <DrawerTitle>Ticket 2481</DrawerTitle>
          <DrawerDescription>Defektes Stationstelefon, gemeldet heute um 09:12.</DrawerDescription>
        </DrawerHeader>
        <div className="flex flex-col gap-3 px-4 text-sm">
          <Badge variant="secondary" className="w-fit">
            In Bearbeitung
          </Badge>
          <p>
            Die Technik hat den Austausch für morgen vorgemerkt. Bis dahin steht ein Ersatzgerät am
            Stationsplatz.
          </p>
        </div>
        <DrawerFooter>
          <DrawerClose asChild>
            <Button variant="outline">Schließen</Button>
          </DrawerClose>
        </DrawerFooter>
      </DrawerContent>
    </Drawer>
  );
}

Barrierefreiheit

  • Die offene Schublade hat die Rolle dialog; den zugänglichen Namen liefert DrawerTitle. Im Komponententest wird sie über getByRole("dialog", { name: "Warenkorb" }) gefunden.
  • Die Beschreibung ist Teil des Dialogs und wird im Test über ihren Text gefunden.
  • Die Schublade baut auf dem Dialog von Radix auf. Damit gilt dessen Tastaturverhalten: Escape schließt sie, und der Fokus kehrt zum Auslöser zurück. Der Seitentest prüft das Schließen mit Escape.
  • Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Drawer
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von DrawerContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von DrawerTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch