Komponenten
Tabelle (DataTable)
StabilTabelle für Dienstpläne, Belegungen und Tickets – sortieren, filtern, auswählen und blättern.
Eine Tabelle ordnet viele gleichartige Einträge in Spalten: die Dienste einer Woche, die Betten einer Station, die offenen Tickets eines Teams. Du sortierst in der Tabelle nach einer Spalte, filterst über das Suchfeld und blätterst durch die Seiten, ohne die Ansicht zu verlassen.
Wann verwenden
- Für Listen mit mehreren Merkmalen pro Eintrag, etwa Mitarbeit, Station, Schicht und Datum im Dienstplan.
- Wenn Nutzer die Reihenfolge ändern müssen: nach Datum, nach Station oder alphabetisch nach Namen.
- Wenn aus vielen Zeilen eine Auswahl getroffen wird, zum Beispiel offene Dienste zum Übernehmen.
- Wenn die Liste länger als eine Bildschirmhöhe ist und Seiten braucht.
Wann nicht
- Für wenige, feste Werte eines einzelnen Datensatzes ist eine Beschreibungsliste ruhiger und schneller zu lesen.
- Für eine kurze Zusammenfassung mit drei Kennzahlen genügen Kennzahlen.
- Wenn nur ein Betrag, ein Status oder ein Satz gezeigt wird, ist eine Karte oder ein Hinweis die passendere Form.
- Für mobile Ansichten mit vielen Spalten prüfe, ob eine Karte pro Eintrag besser funktioniert; die Tabelle scrollt sonst seitlich.
Aufbau der Tabelle
DataTable bekommt columns und data. Jede Spalte beschreibt mit
accessorKey das Feld und mit header die sichtbare Überschrift. Zeigt
header einen Text, wird daraus ein Sortierknopf. Die Werkzeugleiste mit
Suchfeld und Spaltenmenü kommt von selbst; DataTableToolbar lässt sich über
toolbar ersetzen.
| Mert Yilmaz | Station 1 | Frühdienst | Bestätigt | |
| Alina Berger | Station 3 | Spätdienst | Offen | |
| Derya Kaya | Station 2 | Nachtdienst | Bestätigt | |
| Jonas Feld | Station 1 | Spätdienst | Offen | |
| Sofia Marin | Station 3 | Frühdienst | Bestätigt |
Seite 1 von 3
import { Badge, DataTable, type ColumnDef } from "@neodin-eu/ui";
interface Dienst {
id: string;
mitarbeit: string;
station: string;
schicht: string;
status: "Bestätigt" | "Offen";
}
const dienste: Dienst[] = [
{
id: "D-201",
mitarbeit: "Mert Yilmaz",
station: "Station 1",
schicht: "Frühdienst",
status: "Bestätigt",
},
{
id: "D-202",
mitarbeit: "Alina Berger",
station: "Station 3",
schicht: "Spätdienst",
status: "Offen",
},
{
id: "D-203",
mitarbeit: "Derya Kaya",
station: "Station 2",
schicht: "Nachtdienst",
status: "Bestätigt",
},
{
id: "D-204",
mitarbeit: "Jonas Feld",
station: "Station 1",
schicht: "Spätdienst",
status: "Offen",
},
{
id: "D-205",
mitarbeit: "Sofia Marin",
station: "Station 3",
schicht: "Frühdienst",
status: "Bestätigt",
},
{
id: "D-206",
mitarbeit: "Emil Wagner",
station: "Station 2",
schicht: "Frühdienst",
status: "Bestätigt",
},
{
id: "D-207",
mitarbeit: "Nora Haas",
station: "Station 1",
schicht: "Nachtdienst",
status: "Offen",
},
{
id: "D-208",
mitarbeit: "Hakan Demir",
station: "Station 3",
schicht: "Spätdienst",
status: "Bestätigt",
},
{
id: "D-209",
mitarbeit: "Clara Weber",
station: "Station 2",
schicht: "Frühdienst",
status: "Offen",
},
{
id: "D-210",
mitarbeit: "Tim Berger",
station: "Station 1",
schicht: "Frühdienst",
status: "Bestätigt",
},
{
id: "D-211",
mitarbeit: "Lea Schmid",
station: "Station 3",
schicht: "Nachtdienst",
status: "Offen",
},
{
id: "D-212",
mitarbeit: "Oskar Roth",
station: "Station 2",
schicht: "Spätdienst",
status: "Bestätigt",
},
];
const columns: ColumnDef<Dienst>[] = [
{ accessorKey: "mitarbeit", header: "Mitarbeit" },
{ accessorKey: "station", header: "Station" },
{ accessorKey: "schicht", header: "Schicht" },
{
accessorKey: "status",
header: "Status",
cell: ({ row }) => (
<Badge variant={row.original.status === "Offen" ? "secondary" : "outline"}>
{row.original.status}
</Badge>
),
},
];
function Dienstplan() {
return (
<DataTable
className="w-full"
columns={columns}
data={dienste}
enableRowSelection
pageSize={5}
emptyText="Keine Dienste im gewählten Zeitraum"
/>
);
}Sortieren, filtern und blättern
Ein Klick auf „Mitarbeit“, „Station“, „Schicht“ oder „Status“ sortiert
die Tabelle aufsteigend, ein zweiter Klick absteigend. Das Suchfeld filtert
die Tabelle über alle Spalten gleichzeitig. Unter der Tabelle zeigt DataTablePagination die
aktuelle Seite und die Seitenzahlen; pageSize legt fest, wie viele Zeilen
eine Seite enthält.
Zeilen auswählen
Mit enableRowSelection bekommt jede Zeile der Tabelle ein Kontrollkästchen, die Kopfzeile
eines für die ganze Seite. Die Fußzeile nennt die Anzahl der ausgewählten
Zeilen. Für eine Auswahl über mehrere Seiten hinweg steuerst du
rowSelection selbst über state und onRowSelectionChange.
Ohne Einträge
Bleibt data leer oder filtert das Suchfeld alle Zeilen weg, zeigt die
Tabelle einen Hinweis. emptyText ersetzt den Standardtext „Keine Einträge“.
Barrierefreiheit
- Der Sortierzustand steht als
aria-sortan der Kopfzelle:none,ascendingoderdescending. Das ist im Komponententest abgesichert. - Der Sortierknopf ist ein natives
button-Element;EnterundLeertastelösen ihn aus. - Der Filter ist ein Suchfeld mit der Rolle
searchboxund dem zugänglichen Namen „Suchen …“. Im Komponententest wird damit gefiltert. - Auswahl-Kontrollkästchen heißen „Alle auswählen“ und „Zeile auswählen“.
- Das Spaltenmenü ist ein Menü mit Kontrollkästchen-Einträgen („Spalten“).
Pfeiltasten bewegen den Fokus,
Enterschaltet eine Spalte um; das ist Radix-Verhalten. - Ohne Daten erscheint der Text „Keine Einträge“. Die Tabelle ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| columns | ColumnDef<TData, unknown>[] | – | Ja | Column definitions describing headers, cells and accessors. |
| data | TData[] | – | Ja | Rows to display. |
| emptyText | string | – | Nein | Empty state text; defaults to the `noEntries` catalog entry. |
| enableRowSelection | boolean | false | Nein | Adds a leading checkbox column for row selection; defaults to `false`. |
| height | string | number | 32rem | Nein | Height of the virtualised scroll container. |
| mode | enum | client | Nein | Client-side processing (default) or server-side processing. |
| onColumnFiltersChange | OnChangeFn<ColumnFiltersState> | – | Nein | Called with the next column filter state. |
| onColumnVisibilityChange | OnChangeFn<ColumnVisibilityState> | – | Nein | Called with the next column visibility state. |
| onGlobalFilterChange | OnChangeFn<string> | – | Nein | Called with the next global filter term. |
| onPaginationChange | OnChangeFn<PaginationState> | – | Nein | Called with the next pagination state. |
| onRowSelectionChange | OnChangeFn<RowSelectionState> | – | Nein | Called with the next row selection state. |
| onSortingChange | OnChangeFn<SortingState> | – | Nein | Called with the next sorting state. |
| pageSize | number | 10 | Nein | Rows per page; defaults to 10. |
| rowCount | number | – | Nein | Total row count; required for pagination in server mode. |
| state | DataTableState | – | Nein | Controlled state slices. Omitted slices stay uncontrolled. |
| toolbar | ReactNode | – | Nein | Replacement for the built-in toolbar (search and column visibility). |
| virtualize | boolean | { estimateRowHeight: number; } | false | Nein | Virtualise the body; `estimateRowHeight` defaults to 40 pixels. |
Die Werkzeugleiste lässt sich auch einzeln einsetzen:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| searchPlaceholder | string | – | Nein | Placeholder and accessible name of the search field. |
| table | DataTableInstance<TData> | – | Ja | Data table instance whose filters and columns the toolbar controls. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| table | DataTableInstance<TData> | – | Ja | Data table instance whose page state is shown and changed. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| column | DataTableColumn<TData> | – | Ja | Column whose sorting state this header controls. |
| disabled | boolean | – | Nein | – |
| title | string | – | Nein | Visible label; defaults to a string header of the column definition. |