Komponenten
Tabellengerüst (Table)
StabilEine 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
DataTablezu 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.
| Zimmer | Belegte Betten | Stand |
|---|---|---|
| 101 | 2 von 2 | Voll belegt |
| 102 | 1 von 2 | Ein Bett frei |
| 103 | 0 von 1 | Frei |
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.
| Schicht | Eingeteilte Personen |
|---|---|
| Frühdienst | 6 |
| Spätdienst | 5 |
| Nachtdienst | 3 |
| Summe | 14 Personen |
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
TableCaptionwird zum zugänglichen Namen der Tabelle. Im Komponententest wird die Tabelle übergetByRole("table", { name: "Mitglieder" })gefunden.- Kopfzellen tragen
scope="col"und werden als Spaltenkopf ausgegeben. Im Test wirdgetByRole("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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | 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.