Zum Inhalt springen
Dokumentation

Komponenten

Tabellengerüst (Table)

Stabil

Eine schlichte, semantische Tabelle mit Beschriftung, Kopf- und Fußzeile.

Das Tabellengerüst bildet eine Tabelle mit den nativen Elementen table, thead, tbody, tr, th, td und caption ab. Es sortiert und filtert nicht – es zeigt Daten in einer festen Reihenfolge, etwa die Bettenbelegung einer Station zum Stand der Übergabe.

Wann verwenden

  • Für eine überschaubare Tabelle mit fester Reihenfolge, die du selbst zusammenstellst.
  • Wenn eine Beschriftung (TableCaption) den Inhalt einordnet, etwa Stand und Station.
  • Wenn eine Summenzeile am Ende gebraucht wird – dafür gibt es TableFooter.
  • Als Grundlage für eigene Tabellenlogik, wenn DataTable zu viel mitbringt.

Wann nicht

  • Für Listen, die sortiert, gefiltert oder seitenweise geblättert werden, nimm DataTable. Sonst baust du diese Fähigkeiten von Hand nach.
  • Für Bezeichnung-Wert-Paare eines einzelnen Datensatzes ist eine Beschreibungsliste die richtige Wahl.
  • Für ein Layout aus Flächen und Abständen sind Karten oder Abschnitte passender; eine Tabelle ist kein Layout-Raster.

Aufbau

Table umschließt alles und legt den horizontalen Bildlauf an. TableCaption beschreibt die Tabelle, TableHeader trägt die Kopfzeile, TableBody die Datenzeilen. TableHead bekommt scope="col", damit Screenreader die Spalte zuordnen können. TableFooter zeigt Summen oder Hinweise am Ende.

Bettenbelegung Station 3, Stand 08:00 Uhr
ZimmerBelegte BettenStand
1012 von 2Voll belegt
1021 von 2Ein Bett frei
1030 von 1Frei
Beispiel und Quelltext
belegung.tsx
import {
  Table,
  TableBody,
  TableCaption,
  TableCell,
  TableHead,
  TableHeader,
  TableRow,
} from "@neodin-eu/ui";

const zimmer = [
  { nummer: "101", betten: "2 von 2", belegung: "Voll belegt" },
  { nummer: "102", betten: "1 von 2", belegung: "Ein Bett frei" },
  { nummer: "103", betten: "0 von 1", belegung: "Frei" },
];

function Belegung() {
  return (
    <Table>
      <TableCaption>Bettenbelegung Station 3, Stand 08:00 Uhr</TableCaption>
      <TableHeader>
        <TableRow>
          <TableHead scope="col">Zimmer</TableHead>
          <TableHead scope="col">Belegte Betten</TableHead>
          <TableHead scope="col">Stand</TableHead>
        </TableRow>
      </TableHeader>
      <TableBody>
        {zimmer.map((eintrag) => (
          <TableRow key={eintrag.nummer}>
            <TableCell>{eintrag.nummer}</TableCell>
            <TableCell>{eintrag.betten}</TableCell>
            <TableCell>{eintrag.belegung}</TableCell>
          </TableRow>
        ))}
      </TableBody>
    </Table>
  );
}

Kopf- und Fußzeile

Beschriftungen im Kopf stehen in Großbuchstaben und kleiner Schrift, damit die Datenzeilen ruhig bleiben. Die Fußzeile ist durch eine Linie abgesetzt und trägt Summen – hier die eingeteilten Personen aller Schichten.

Dienste am 18.11.2026, Station 3
SchichtEingeteilte Personen
Frühdienst6
Spätdienst5
Nachtdienst3
Summe14 Personen
Beispiel und Quelltext
fusszeile.tsx
import {
  Table,
  TableBody,
  TableCaption,
  TableCell,
  TableFooter,
  TableHead,
  TableHeader,
  TableRow,
} from "@neodin-eu/ui";

const dienste = [
  { schicht: "Frühdienst", personen: 6 },
  { schicht: "Spätdienst", personen: 5 },
  { schicht: "Nachtdienst", personen: 3 },
];

function Fusszeile() {
  return (
    <Table>
      <TableCaption>Dienste am 18.11.2026, Station 3</TableCaption>
      <TableHeader>
        <TableRow>
          <TableHead scope="col">Schicht</TableHead>
          <TableHead scope="col">Eingeteilte Personen</TableHead>
        </TableRow>
      </TableHeader>
      <TableBody>
        {dienste.map((eintrag) => (
          <TableRow key={eintrag.schicht}>
            <TableCell>{eintrag.schicht}</TableCell>
            <TableCell>{eintrag.personen}</TableCell>
          </TableRow>
        ))}
      </TableBody>
      <TableFooter>
        <TableRow>
          <TableCell>Summe</TableCell>
          <TableCell>14 Personen</TableCell>
        </TableRow>
      </TableFooter>
    </Table>
  );
}

Barrierefreiheit

  • TableCaption wird zum zugänglichen Namen der Tabelle. Im Komponententest wird die Tabelle über getByRole("table", { name: "Mitglieder" }) gefunden.
  • Kopfzellen tragen scope="col" und werden als Spaltenkopf ausgegeben. Im Test wird getByRole("columnheader", …) geprüft.
  • Datenzellen haben die Rolle cell; Screenreader lesen Zeile und Spalte anhand der semantischen Elemente vor.
  • Die Tabelle ist im Komponententest in hell und dunkel frei von axe-Verstößen.
  • Bei schmalen Bildschirmen scrollt die Tabelle innerhalb ihres Rahmens seitlich, nicht die ganze Seite.

Props

Props von Table
PropTypStandardPflichtBeschreibung
classNamestring–Nein–

Die übrigen Teile (TableHeader, TableBody, TableRow, TableHead, TableCell, TableFooter, TableCaption) nehmen die Attribute ihres nativen Elements entgegen; zusätzlich lässt sich jeweils className setzen.

Siehe auch