Zum Inhalt springen
Dokumentation

Grundlagen

Dichte

Stabil

Zwei Stufen für den Platzbedarf: comfortable und compact über NeodinProvider, data-density und die Variablen --control-h und --cell-py.

Dichte bestimmt, wie viel Platz eine Oberfläche pro Zeile belegt. Sie ändert keine Farben und keine Schriftgrößen, sondern zwei Maße: die Höhe der Eingabefelder und den Abstand in den Zellen der DataTable. In einem Formular am Empfang darf es großzügig zugehen, in einer Stationsliste mit vielen Zeilen eng.

Die zwei Stufen

NeodinProvider kennt density="comfortable" (Standard) und density="compact". Der Provider setzt dafür data-density auf ein Hüllenelement; die Regel [data-density="compact"] in styles.css setzt die beiden Variablen für alles darunter neu.

Stufe--control-h--cell-py
comfortable2,25 rem (36 px)0,75 rem (12 px)
compact1,875 rem (30 px)0,375 rem (6 px)

Ohne Provider gelten comfortable und de-AT. Ein verschachtelter Provider wechselt die Dichte nur für seinen Teilbaum; die Doku nutzt das für den Vergleich unten. Ein Produkt wählt eine Dichte für das ganze Dokument und bleibt dabei.

Welche Komponenten der Dichte folgen

Diese Komponenten ziehen ihre Höhe aus --control-h und werden mit compact sichtbar niedriger:

  • Button (alle Größen: sm ist 4 px niedriger, lg 4 px höher als die Grundhöhe, icon ist quadratisch) und Input
  • NumberInput, PasswordInput, InputOTP, TagInput und Combobox
  • Command (die Eingabezeile der Befehlspalette)
  • DatePicker, DateRangePicker und TimePicker

TagInput und Combobox arbeiten mit min-height, wachsen also bei mehreren Zeilen mit. PasswordInput gibt die Höhe an das innere Eingabefeld weiter.

Nur die DataTable liest --cell-py: Sie setzt den Wert als senkrechtes Polster ihrer Körperzellen. Die Kopfzeile der Tabelle behält ihre feste Höhe.

Was fest bleibt

Fest sind die Höhen von SelectTrigger (h-9), TableHead (h-10), Tabs und Menubar (h-9). Sie sind nicht Teil der Dichte.

Beispiel: beide Stufen nebeneinander

Zwei Provider, gleicher Inhalt: links comfortable, rechts compact. Das Zahlenfeld und die Tabellenzellen ändern sich, der Rahmen bleibt gleich.

density="comfortable"

1012 von 2Voll belegt
1021 von 2Frei
1030 von 2Frei
1042 von 2Voll belegt

Seite 1 von 1

density="compact"

1012 von 2Voll belegt
1021 von 2Frei
1030 von 2Frei
1042 von 2Voll belegt

Seite 1 von 1

Beispiel und Quelltext
vergleich.tsx
import * as React from "react";

import {
  DataTable,
  Label,
  NeodinProvider,
  NumberInput,
  type ColumnDef,
  type NeodinDensity,
} from "@neodin-eu/ui";

interface Zimmer {
  id: string;
  zimmer: string;
  belegt: string;
  status: string;
}

const zimmer: Zimmer[] = [
  { id: "101", zimmer: "101", belegt: "2 von 2", status: "Voll belegt" },
  { id: "102", zimmer: "102", belegt: "1 von 2", status: "Frei" },
  { id: "103", zimmer: "103", belegt: "0 von 2", status: "Frei" },
  { id: "104", zimmer: "104", belegt: "2 von 2", status: "Voll belegt" },
];

const columns: ColumnDef<Zimmer>[] = [
  { accessorKey: "zimmer", header: "Zimmer" },
  { accessorKey: "belegt", header: "Belegung" },
  { accessorKey: "status", header: "Status" },
];

function Ausschnitt({ dichte }: { dichte: NeodinDensity }) {
  const [betten, setBetten] = React.useState<number | null>(4);

  return (
    <NeodinProvider
      density={dichte}
      messages={{
        pagination:
          dichte === "compact"
            ? "Seitennavigation kompakte Dichte"
            : "Seitennavigation komfortable Dichte",
      }}
    >
      <div className="flex flex-col gap-4 rounded-md border border-border bg-background p-4">
        <p className="font-mono text-xs text-muted-foreground">{`density="${dichte}"`}</p>
        <div className="flex flex-col gap-2">
          <Label htmlFor={`betten-${dichte}`}>Freie Betten, Station 3</Label>
          <NumberInput
            id={`betten-${dichte}`}
            value={betten}
            onValueChange={setBetten}
            min={0}
            max={24}
          />
        </div>
        <DataTable columns={columns} data={zimmer} pageSize={4} />
      </div>
    </NeodinProvider>
  );
}

function DichteVergleich() {
  return (
    <div className="grid w-full gap-4 lg:grid-cols-2">
      <Ausschnitt dichte="comfortable" />
      <Ausschnitt dichte="compact" />
    </div>
  );
}

Wann welche Dichte

  • comfortable für Formulare, Dialoge und alles, was am Empfang oder auf einem Tablet mit wenig Zeilen bedient wird. Das ist der Standard.
  • compact für Datenoberflächen mit vielen Zeilen: Dienstplan, Belegungsliste, Ticketliste.
  • Keine Mischung innerhalb einer Ansicht. Zwei Stufen auf einem Bildschirm verwirren mehr, als sie Platz sparen; der Vergleich oben ist eine Dokumentationshilfe, kein Muster für Produkte.

Barrierefreiheit

  • Die Dichte ändert nur Abstände, keine Schriftgrößen. Kontraste und Textgrößen bleiben in beiden Stufen gleich.
  • Ein kompaktes Eingabefeld ist 30 px hoch. Das liegt über der Mindestgröße von 24 × 24 px, die WCAG 2.2 (Erfolgskriterium 2.5.8) für Zeigerziele verlangt. Auch ein kompakter Button in Größe sm liegt mit 26 px darüber.
  • Das Hüllenelement des Providers hat display: contents, keine Rolle und keinen Fokus; es erzeugt keinen sichtbaren Kasten. Der Komponententest prüft das Attribut data-density.
  • Bei mehrzeiligen Zellen in compact prüfst du, ob der Zeilenabstand noch reicht; 6 px Polster sind für eine Zeile mit Statusabzeichen gedacht.
  • Stehen zwei Tabellen auf einer Seite, braucht jede eigene Seitennavigation einen eigenen Namen. Das Beispiel überschreibt dafür den Katalogschlüssel pagination je Provider; ohne den Zusatz wären zwei Navigationsbereiche namens „Seitennavigation“ nicht unterscheidbar.

Siehe auch