Zum Inhalt springen
Dokumentation

Komponenten

Tabelle (DataTable)

Stabil

Tabelle 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 YilmazStation 1FrühdienstBestätigt
Alina BergerStation 3SpätdienstOffen
Derya KayaStation 2NachtdienstBestätigt
Jonas FeldStation 1SpätdienstOffen
Sofia MarinStation 3FrühdienstBestätigt

Seite 1 von 3

Beispiel und Quelltext
dienstplan.tsx
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-sort an der Kopfzelle: none, ascending oder descending. Das ist im Komponententest abgesichert.
  • Der Sortierknopf ist ein natives button-Element; Enter und Leertaste lösen ihn aus.
  • Der Filter ist ein Suchfeld mit der Rolle searchbox und 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, Enter schaltet 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

Props von DataTable
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
columnsColumnDef<TData, unknown>[]–JaColumn definitions describing headers, cells and accessors.
dataTData[]–JaRows to display.
emptyTextstring–NeinEmpty state text; defaults to the `noEntries` catalog entry.
enableRowSelectionbooleanfalseNeinAdds a leading checkbox column for row selection; defaults to `false`.
heightstring | number32remNeinHeight of the virtualised scroll container.
modeenumclientNeinClient-side processing (default) or server-side processing.
onColumnFiltersChangeOnChangeFn<ColumnFiltersState>–NeinCalled with the next column filter state.
onColumnVisibilityChangeOnChangeFn<ColumnVisibilityState>–NeinCalled with the next column visibility state.
onGlobalFilterChangeOnChangeFn<string>–NeinCalled with the next global filter term.
onPaginationChangeOnChangeFn<PaginationState>–NeinCalled with the next pagination state.
onRowSelectionChangeOnChangeFn<RowSelectionState>–NeinCalled with the next row selection state.
onSortingChangeOnChangeFn<SortingState>–NeinCalled with the next sorting state.
pageSizenumber10NeinRows per page; defaults to 10.
rowCountnumber–NeinTotal row count; required for pagination in server mode.
stateDataTableState–NeinControlled state slices. Omitted slices stay uncontrolled.
toolbarReactNode–NeinReplacement for the built-in toolbar (search and column visibility).
virtualizeboolean | { estimateRowHeight: number; }falseNeinVirtualise the body; `estimateRowHeight` defaults to 40 pixels.

Die Werkzeugleiste lässt sich auch einzeln einsetzen:

Props von DataTableToolbar
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
searchPlaceholderstring–NeinPlaceholder and accessible name of the search field.
tableDataTableInstance<TData>–JaData table instance whose filters and columns the toolbar controls.
Props von DataTablePagination
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
tableDataTableInstance<TData>–JaData table instance whose page state is shown and changed.
Props von DataTableColumnHeader
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
columnDataTableColumn<TData>–JaColumn whose sorting state this header controls.
disabledboolean–Nein–
titlestring–NeinVisible label; defaults to a string header of the column definition.

Siehe auch