Zum Inhalt springen
Dokumentation

Muster

App-Gerüst

Stabil

Seitenleiste, 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

  • Sidebar trägt die Navigation. Sie bleibt auf dem Desktop sichtbar und wird auf schmalen Geräten zum Dialog; SidebarTrigger schaltet sie um.
  • Die Kopfzeile nennt den Kontext („Frühdienst · Station 3“) und hält ThemeToggle griffbereit. Der Umschalter gehört in die Kopfzeile, weil er für die ganze Ansicht gilt, nicht für einen einzelnen Bereich.
  • StatTile beantwortet 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.
  • Table zeigt die Details darunter, hier die Belegung pro Zimmer. Für sortier- und filterbare Listen tritt an ihre Stelle DataTable.

Das Beispiel

Frühdienst · Station 3
Offene Dienste2Stand heute, 08:00 Uhr
Bettenbelegung84 %Station 3
Offene Übergaben5Frühdienst
Belegung der Station 3, Stand 08:00 Uhr
ZimmerBelegungStatus
3012 von 2voll
3021 von 2frei
3032 von 2voll
Beispiel und Quelltext
app-geruest.tsx
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: value nimmt Zahlen oder fertige Texte, format nutzt Intl.NumberFormat, delta zeigt die Richtung.
  • Die Tabelle: Spalten, Beschriftung über TableCaption und die Daten deiner Ansicht.

Siehe auch