Muster
App-Gerüst
StabilSeitenleiste, Kopfzeile mit Theme-Umschalter, Kennzahlen und eine Tabelle – der Rahmen einer Stationsansicht.
Dieses Muster setzt eine ganze Ansicht zusammen: links die Seitenleiste mit den Bereichen, oben die Kopfzeile mit Umschalter und Theme-Wechsel, darunter drei Kennzahlen und eine Tabelle mit der Belegung. Es zeigt, wie die Bausteine in einer Anwendung zusammenwirken.
Warum diese Kombination
Sidebarträgt die Navigation. Sie bleibt auf dem Desktop sichtbar und wird auf schmalen Geräten zum Dialog;SidebarTriggerschaltet sie um.- Die Kopfzeile nennt den Kontext („Frühdienst · Station 3“) und hält
ThemeTogglegriffbereit. Der Umschalter gehört in die Kopfzeile, weil er für die ganze Ansicht gilt, nicht für einen einzelnen Bereich. StatTilebeantwortet die erste Frage beim Öffnen: Wie viele Dienste sind offen, wie voll ist die Station? Drei Kennzahlen reichen; mehr drängen die Tabelle nach unten.Tablezeigt die Details darunter, hier die Belegung pro Zimmer. Für sortier- und filterbare Listen tritt an ihre StelleDataTable.
Das Beispiel
| Zimmer | Belegung | Status |
|---|---|---|
| 301 | 2 von 2 | voll |
| 302 | 1 von 2 | frei |
| 303 | 2 von 2 | voll |
import { CalendarDays, ClipboardList, LayoutDashboard } from "lucide-react";
import * as React from "react";
import {
Sidebar,
SidebarContent,
SidebarFooter,
SidebarGroup,
SidebarGroupLabel,
SidebarHeader,
SidebarMenu,
SidebarMenuButton,
SidebarMenuItem,
SidebarProvider,
SidebarTrigger,
StatTile,
Table,
TableBody,
TableCaption,
TableCell,
TableHead,
TableHeader,
TableRow,
ThemeToggle,
useSidebar,
} from "@neodin-eu/ui";
function Eintrag({
icon,
label,
active = false,
}: {
icon: React.ReactNode;
label: string;
active?: boolean;
}) {
const { state } = useSidebar();
return (
<SidebarMenuButton isActive={active} tooltip={label}>
{icon}
<span className={state === "collapsed" ? "sr-only" : undefined}>{label}</span>
</SidebarMenuButton>
);
}
function AppGeruest() {
return (
<div
data-testid="muster-app-geruest"
className="relative w-full max-w-3xl overflow-hidden rounded-lg border border-border"
>
<SidebarProvider className="h-[30rem] min-h-0 bg-background">
<Sidebar className="h-full">
<SidebarHeader>
<span className="px-2 text-sm font-semibold text-foreground">Station 3</span>
</SidebarHeader>
<SidebarContent>
<SidebarGroup>
<SidebarGroupLabel>Dienstplan</SidebarGroupLabel>
<SidebarMenu>
<SidebarMenuItem>
<Eintrag icon={<LayoutDashboard />} label="Übersicht" active />
</SidebarMenuItem>
<SidebarMenuItem>
<Eintrag icon={<CalendarDays />} label="Schichten" />
</SidebarMenuItem>
<SidebarMenuItem>
<Eintrag icon={<ClipboardList />} label="Übergaben" />
</SidebarMenuItem>
</SidebarMenu>
</SidebarGroup>
</SidebarContent>
<SidebarFooter>
<span className="px-2 text-xs text-muted-foreground">Version 1.4</span>
</SidebarFooter>
</Sidebar>
<div className="flex min-w-0 flex-1 flex-col">
<header className="flex min-h-14 items-center gap-2 border-b border-border px-3 py-2">
<SidebarTrigger />
<span className="text-sm font-medium text-foreground">Frühdienst · Station 3</span>
<span className="flex-1" />
<ThemeToggle />
</header>
<div className="min-h-0 flex-1 overflow-auto p-4">
<div className="grid gap-3 sm:grid-cols-3">
<StatTile label="Offene Dienste" value={2} hint="Stand heute, 08:00 Uhr" />
<StatTile
label="Bettenbelegung"
value={0.84}
format={{ style: "percent", maximumFractionDigits: 0 }}
hint="Station 3"
/>
<StatTile label="Offene Übergaben" value={5} hint="Frühdienst" />
</div>
<div className="mt-4 rounded-lg border border-border bg-background">
<Table>
<TableCaption>Belegung der Station 3, Stand 08:00 Uhr</TableCaption>
<TableHeader>
<TableRow>
<TableHead scope="col">Zimmer</TableHead>
<TableHead scope="col">Belegung</TableHead>
<TableHead scope="col">Status</TableHead>
</TableRow>
</TableHeader>
<TableBody>
<TableRow>
<TableCell>301</TableCell>
<TableCell>2 von 2</TableCell>
<TableCell>voll</TableCell>
</TableRow>
<TableRow>
<TableCell>302</TableCell>
<TableCell>1 von 2</TableCell>
<TableCell>frei</TableCell>
</TableRow>
<TableRow>
<TableCell>303</TableCell>
<TableCell>2 von 2</TableCell>
<TableCell>voll</TableCell>
</TableRow>
</TableBody>
</Table>
</div>
</div>
</div>
</SidebarProvider>
</div>
);
}Begrenzte Vorschau
AppShell setzt genau diese Teile zusammen: sidebar, header und
children. In der Vorschau stehen die Teile einzeln in einem begrenzten
Rahmen mit fester Höhe und overflow-hidden. Der Grund ist derselbe wie auf
der Komponentenseite: AppShell rendert über SidebarInset ein
main-Element, und diese Dokumentationsseite besitzt bereits eines. Ein
zweites main wäre ein Landmark-Fehler. In deiner Anwendung nimmst du
AppShell und bekommst denselben Aufbau ohne zusätzliches Gerüst.
Der Rahmen begrenzt auch die Höhe: Die Seitenleiste füllt die Karte über
h-full, der Inhalt scrollt in sich. So bleibt die Vorschau an ihrem Platz,
statt die Seite zu übernehmen.
Was du anpasst
- Die Einträge der Seitenleiste und der aktive Eintrag über
isActive. - Die Kopfzeile: Kontext links, Aktionen rechts.
- Die Kennzahlen:
valuenimmt Zahlen oder fertige Texte,formatnutztIntl.NumberFormat,deltazeigt die Richtung. - Die Tabelle: Spalten, Beschriftung über
TableCaptionund die Daten deiner Ansicht.