Zum Inhalt springen
Dokumentation

Komponenten

Seitenpanel (Sheet)

Stabil

Filter, Navigation und kurze Zusatzinhalte, die von der Seite hereingleiten – ohne die Hauptseite zu verdecken.

Ein Seitenpanel schiebt sich von der Seite herein und zeigt eine Nebensache: Filter, Stationen oder eine kurze Zusammenfassung. Die Hauptseite bleibt sichtbar und wartet im Hintergrund.

Wann verwenden

  • Für Filter und Einstellungen, die du neben der Liste brauchst, etwa die Bettenbelegung nach Station und Schicht.
  • Für eine Navigation auf schmalen Bildschirmen, etwa die Stationen eines Hauses.
  • Für kurze Zusatzinhalte, die die Seite nicht dauerhaft belegen sollen.

Wann nicht

  • Für eine Aufgabe, die den Fokus vollständig braucht, ist der Dialog passender.
  • Für dauerhaft sichtbare Navigation auf breiten Bildschirmen gibt es die Sidebar im App-Gerüst.
  • Für eine Rückfrage vor einer Aktion nimm den Bestätigungsdialog.
  • Für ein kurzes Detail am Rand reicht oft ein Popover.

Filter öffnen

Sheet hält den Zustand, SheetTrigger öffnet, SheetContent zeigt den Inhalt. side bestimmt die Richtung und steht standardmäßig auf right. Kopf und Fuß kommen aus SheetHeader und SheetFooter; Titel und Beschreibung aus SheetTitle und SheetDescription benennen das Panel für Screenreader.

Beispiel und Quelltext
filter.tsx
import {
  Button,
  Label,
  Select,
  SelectContent,
  SelectItem,
  SelectTrigger,
  SelectValue,
  Sheet,
  SheetClose,
  SheetContent,
  SheetDescription,
  SheetFooter,
  SheetHeader,
  SheetTitle,
  SheetTrigger,
} from "@neodin-eu/ui";

function Filter() {
  return (
    <Sheet>
      <SheetTrigger asChild>
        <Button variant="outline">Filter öffnen</Button>
      </SheetTrigger>
      <SheetContent>
        <SheetHeader>
          <SheetTitle>Station filtern</SheetTitle>
          <SheetDescription>
            Grenze die Bettenbelegung nach Station und Schicht ein.
          </SheetDescription>
        </SheetHeader>
        <div className="flex flex-col gap-4">
          <div className="flex flex-col gap-2">
            <Label htmlFor="filter-station">Station</Label>
            <Select defaultValue="innere">
              <SelectTrigger id="filter-station" className="w-full">
                <SelectValue placeholder="Station wählen" />
              </SelectTrigger>
              <SelectContent>
                <SelectItem value="notaufnahme">Notaufnahme</SelectItem>
                <SelectItem value="innere">Innere Medizin</SelectItem>
                <SelectItem value="chirurgie">Chirurgie</SelectItem>
                <SelectItem value="intensiv">Intensivstation</SelectItem>
              </SelectContent>
            </Select>
          </div>
          <div className="flex flex-col gap-2">
            <Label htmlFor="filter-schicht">Schicht</Label>
            <Select defaultValue="frueh">
              <SelectTrigger id="filter-schicht" className="w-full">
                <SelectValue placeholder="Schicht wählen" />
              </SelectTrigger>
              <SelectContent>
                <SelectItem value="frueh">Frühschicht (06:00–14:00)</SelectItem>
                <SelectItem value="spaet">Spätschicht (14:00–22:00)</SelectItem>
                <SelectItem value="nacht">Nachtschicht (22:00–06:00)</SelectItem>
              </SelectContent>
            </Select>
          </div>
        </div>
        <SheetFooter>
          <SheetClose asChild>
            <Button variant="outline">Zurücksetzen</Button>
          </SheetClose>
          <SheetClose asChild>
            <Button>Filter anwenden</Button>
          </SheetClose>
        </SheetFooter>
      </SheetContent>
    </Sheet>
  );
}

Mit side="left" öffnet sich das Panel von links – auf dem Telefon eine gewohnte Stelle für Navigation. Die Breite ist auf kleinen Bildschirmen begrenzt, auf größeren bleibt sie schmal.

Beispiel und Quelltext
stationen.tsx
import {
  Button,
  Sheet,
  SheetClose,
  SheetContent,
  SheetDescription,
  SheetHeader,
  SheetTitle,
  SheetTrigger,
} from "@neodin-eu/ui";

const stationen = ["Notaufnahme", "Innere Medizin", "Chirurgie", "Intensivstation"];

function Stationen() {
  return (
    <Sheet>
      <SheetTrigger asChild>
        <Button variant="ghost">Stationen</Button>
      </SheetTrigger>
      <SheetContent side="left">
        <SheetHeader>
          <SheetTitle>Stationen</SheetTitle>
          <SheetDescription>Wechsle die Ansicht für die Bettenbelegung.</SheetDescription>
        </SheetHeader>
        <nav aria-label="Stationen" className="flex flex-col gap-1">
          {stationen.map((station) => (
            <SheetClose asChild key={station}>
              <Button variant="ghost" className="justify-start">
                {station}
              </Button>
            </SheetClose>
          ))}
        </nav>
      </SheetContent>
    </Sheet>
  );
}

Barrierefreiheit

  • Das offene Panel hat die Rolle dialog; im Komponententest wird es über getByRole("dialog") gefunden. Den zugänglichen Namen liefert SheetTitle.
  • Der Schließen-Knopf ist über den Nachrichtenkatalog als „Schließen“ beschriftet. Das ist im Komponententest abgesichert.
  • Escape schließt das Panel und setzt den Fokus zurück auf den Auslöser. Das ist im Komponententest abgesichert.
  • Solange das Panel offen ist, hält Radix den Fokus darin und blendet den Rest der Seite für Screenreader aus.
  • Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen; jede Richtung (top, right, bottom, left) wird geprüft.

Props

Props von Sheet
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von SheetContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
showCloseButtonbooleantrueNeinRenders the close button in the top corner; defaults to `true`.
side"left" | "right" | "top" | "bottom" | nullrightNeinEdge of the screen the sheet slides in from; defaults to `"right"`.
Props von SheetTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch