Komponenten
Seitenpanel (Sheet)
StabilFilter, 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.
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>
);
}Von links auf schmalen Bildschirmen
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.
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 übergetByRole("dialog")gefunden. Den zugänglichen Namen liefertSheetTitle. - Der Schließen-Knopf ist über den Nachrichtenkatalog als „Schließen“ beschriftet. Das ist im Komponententest abgesichert.
Escapeschließ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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| showCloseButton | boolean | true | Nein | Renders the close button in the top corner; defaults to `true`. |
| side | "left" | "right" | "top" | "bottom" | null | right | Nein | Edge of the screen the sheet slides in from; defaults to `"right"`. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |