Grundlagen
Dichte
StabilZwei 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 |
|---|---|---|
comfortable | 2,25 rem (36 px) | 0,75 rem (12 px) |
compact | 1,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:smist 4 px niedriger,lg4 px höher als die Grundhöhe,iconist quadratisch) undInputNumberInput,PasswordInput,InputOTP,TagInputundComboboxCommand(die Eingabezeile der Befehlspalette)DatePicker,DateRangePickerundTimePicker
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"
| 101 | 2 von 2 | Voll belegt |
| 102 | 1 von 2 | Frei |
| 103 | 0 von 2 | Frei |
| 104 | 2 von 2 | Voll belegt |
Seite 1 von 1
density="compact"
| 101 | 2 von 2 | Voll belegt |
| 102 | 1 von 2 | Frei |
| 103 | 0 von 2 | Frei |
| 104 | 2 von 2 | Voll belegt |
Seite 1 von 1
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
comfortablefür Formulare, Dialoge und alles, was am Empfang oder auf einem Tablet mit wenig Zeilen bedient wird. Das ist der Standard.compactfü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
Buttonin Größesmliegt 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 Attributdata-density. - Bei mehrzeiligen Zellen in
compactprü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
paginationje Provider; ohne den Zusatz wären zwei Navigationsbereiche namens „Seitennavigation“ nicht unterscheidbar.