Zum Inhalt springen
Dokumentation

Komponenten

Geteilte Fläche (Resizable)

Stabil

Zwei Bereiche nebeneinander, deren Grenze sich mit Maus und Tastatur verschieben lässt.

Eine geteilte Fläche zeigt zwei Bereiche nebeneinander – links die Liste der Zimmer, rechts die Angaben zum gewählten Zimmer. Die Grenze dazwischen lässt sich verschieben, damit beide Seiten den Platz bekommen, den sie gerade brauchen.

Wann verwenden

  • Für Übersicht und Detail nebeneinander, etwa Bettenliste und Zimmerangaben.
  • Wenn beide Bereiche gleichzeitig sichtbar bleiben sollen und ihre Breite je nach Aufgabe unterschiedlich wichtig ist.
  • Wenn die Aufteilung auch ohne Maus funktionieren muss – die Grenze ist fokussierbar und reagiert auf die Pfeiltasten.

Wann nicht

  • Auf schmalen Bildschirmen bleibt für zwei Bereiche kein Platz. Dort gehören Liste und Detail untereinander oder in ein Sheet.
  • Für Bereiche, die nie gleichzeitig gebraucht werden, sind Tabs einfacher.
  • Wenn die Aufteilung fest ist, genügt ein Raster ohne bewegliche Grenze – es ist ruhiger und braucht weniger Erklärung.

Aufbau

ResizablePanelGroup legt die Richtung über orientation fest, ResizablePanel sind die Bereiche und ResizableHandle die bewegliche Grenze. Größenangaben wie defaultSize="40" und minSize="25" sind Prozentwerte; Zahlen ohne Einheit werden als Pixel gelesen. Mit withHandle zeigt die Grenze einen Griff.

Station 3

  • Zimmer 101 · Belegt
  • Zimmer 102 · Belegt
  • Zimmer 103 · Frei
  • Zimmer 104 · Belegt

Zimmer 102

Belegt seit Montag. Visite um 9 Uhr, Entlassung für Donnerstag geplant.

Beispiel und Quelltext
station.tsx
import { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "@neodin-eu/ui";

function Station() {
  return (
    <div className="h-56 w-full max-w-xl">
      <ResizablePanelGroup orientation="horizontal" className="rounded-md border border-border">
        <ResizablePanel defaultSize="40" minSize="25">
          <div className="p-3">
            <p className="text-sm font-semibold text-foreground">Station 3</p>
            <ul className="mt-2 flex flex-col gap-1 text-sm text-muted-foreground">
              <li>Zimmer 101 · Belegt</li>
              <li>Zimmer 102 · Belegt</li>
              <li>Zimmer 103 · Frei</li>
              <li>Zimmer 104 · Belegt</li>
            </ul>
          </div>
        </ResizablePanel>
        <ResizableHandle withHandle />
        <ResizablePanel defaultSize="60" minSize="25" className="bg-muted/30">
          <div className="p-3">
            <p className="text-sm font-semibold text-foreground">Zimmer 102</p>
            <p className="mt-2 text-sm text-muted-foreground">
              Belegt seit Montag. Visite um 9 Uhr, Entlassung für Donnerstag geplant.
            </p>
          </div>
        </ResizablePanel>
      </ResizablePanelGroup>
    </div>
  );
}

Oben und unten teilen

Mit orientation="vertical" teilt die Gruppe die Höhe. Das passt für einen Dienstplan über den offenen Schichten innerhalb einer festen Karte.

Dienstplan heute

Frühdienst mit vier Personen besetzt, Spätdienst mit drei.

Offene Schichten

Nachtdienst am Samstag ist unbesetzt.

Beispiel und Quelltext
hoehe.tsx
import { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "@neodin-eu/ui";

function Hoehe() {
  return (
    <div className="h-64 w-full max-w-md">
      <ResizablePanelGroup orientation="vertical" className="rounded-md border border-border">
        <ResizablePanel defaultSize="60" minSize="30">
          <div className="p-3">
            <p className="text-sm font-semibold text-foreground">Dienstplan heute</p>
            <p className="mt-2 text-sm text-muted-foreground">
              Frühdienst mit vier Personen besetzt, Spätdienst mit drei.
            </p>
          </div>
        </ResizablePanel>
        <ResizableHandle withHandle />
        <ResizablePanel defaultSize="40" minSize="20" className="bg-muted/30">
          <div className="p-3">
            <p className="text-sm font-semibold text-foreground">Offene Schichten</p>
            <p className="mt-2 text-sm text-muted-foreground">
              Nachtdienst am Samstag ist unbesetzt.
            </p>
          </div>
        </ResizablePanel>
      </ResizablePanelGroup>
    </div>
  );
}

Barrierefreiheit

  • ResizableHandle rendert ein Element mit der Rolle separator und tabindex="0". Bei einer waagerechten Gruppe trägt es aria-orientation="vertical". Der aktuelle Stand steht in aria-valuenow; alles drei prüft der Komponententest.
  • Die Pfeiltasten verschieben die Grenze: ArrowRight vergrößert den linken Bereich, ArrowLeft stellt ihn wieder her. Das ist im Komponententest abgesichert.
  • Das Griff-Symbol aus withHandle ist aria-hidden und trägt damit keinen eigenen Namen; der zugängliche Name kommt aus der Rolle separator.
  • Ein gesperrter Griff nimmt über disabled nicht am Verschieben teil.
  • Die Gruppe ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von ResizablePanelGroup
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–NeinDisable resize functionality.
Props von ResizablePanel
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–NeinWhen disabled, a panel cannot be resized either directly or indirectly (by resizing another panel).
Props von ResizableHandle
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–NeinWhen disabled, the separator cannot be used to resize its neighboring panels. ℹ️ The panels may still be resized indirectly (while other panels are being resized). To prevent a panel from being resized at all, it needs to also be disabled.
withHandlebooleanfalseNeinRenders a visible grip in the middle of the handle; defaults to `false`.

Siehe auch