Komponenten
Reiter (Tabs)
StabilMehrere Ansichten derselben Seite umschalten – ohne die Seite zu verlassen.
Reiter wechseln zwischen Ansichten derselben Seite: Übersicht, Belegung und Übergabe einer Station gehören zusammen und teilen sich den Platz. Der Inhalt bleibt im Dokument, nur das sichtbare Panel ändert sich.
Wann verwenden
- Wenn mehrere gleichrangige Ansichten denselben Platz belegen und nur eine davon gleichzeitig gebraucht wird, etwa „Übersicht“ und „Belegung“ einer Station.
- Wenn die Ansichten in einer festen Reihenfolge stehen und ohne Datenverlust gewechselt werden soll.
- Wenn du den Wechsel selbst steuerst:
valueundonValueChangehalten den aktiven Reiter in deinem Zustand, etwa um den Zeitraum im Dienstplan zu merken.
Wann nicht
- Für Schritte einer Reihenfolge sind Reiter falsch: Dort führt ein Weg durch
den Ablauf. Nimm
Stepperzur Orientierung undButtonfür „Weiter“. - Für Seiten, die eigene Adressen brauchen, sind Links die richtige Wahl. Ein Reiter ändert die URL nicht, ein Link schon.
- Für viele gleichartige Bereiche untereinander sind Überschriften und Abschnitte ruhiger als eine Reihe von Reitern.
Aufbau
Tabs hält den aktiven Wert, TabsList die Reihe der Reiter, TabsTrigger
den einzelnen Reiter und TabsContent den zugehörigen Inhalt. Die Zuordnung
läuft über das gemeinsame value; ohne value merkt sich Tabs den Reiter
selbst und startet mit defaultValue.
- Zimmer 301 · belegt
- Zimmer 302 · frei
- Zimmer 303 · Reinigung
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@neodin-eu/ui";
function Station() {
return (
<Tabs defaultValue="belegung" className="w-full max-w-md">
<TabsList aria-label="Stationsansichten">
<TabsTrigger value="uebersicht">Übersicht</TabsTrigger>
<TabsTrigger value="belegung">Belegung</TabsTrigger>
<TabsTrigger value="uebergabe">Übergabe</TabsTrigger>
</TabsList>
<TabsContent value="uebersicht">
<p className="text-sm text-muted-foreground">
Station 3 · 24 Betten · Frühdienst vollständig besetzt.
</p>
</TabsContent>
<TabsContent value="belegung">
<ul className="flex flex-col gap-1 text-sm">
<li>Zimmer 301 · belegt</li>
<li>Zimmer 302 · frei</li>
<li>Zimmer 303 · Reinigung</li>
</ul>
</TabsContent>
<TabsContent value="uebergabe">
<p className="text-sm text-muted-foreground">
Übergabe an den Spätdienst um 14:00 – Liste im Stationsordner.
</p>
</TabsContent>
</Tabs>
);
}Gesteuerte Reiter
Mit value und onValueChange bestimmst du den aktiven Reiter. So lässt sich
der Zustand außerhalb der Komponente auswerten oder ein Reiter sperren, der
noch nicht freigegeben ist.
Kalenderwoche 47 · 5 Dienste sind noch offen.
import * as React from "react";
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@neodin-eu/ui";
function Dienstplan() {
const [zeitraum, setZeitraum] = React.useState("woche");
return (
<Tabs value={zeitraum} onValueChange={setZeitraum} className="w-full max-w-md">
<TabsList aria-label="Zeitraum">
<TabsTrigger value="woche">Woche</TabsTrigger>
<TabsTrigger value="monat">Monat</TabsTrigger>
<TabsTrigger value="archiv" disabled>
Archiv
</TabsTrigger>
</TabsList>
<TabsContent value="woche">
<p className="text-sm text-muted-foreground">
Kalenderwoche 47 · 5 Dienste sind noch offen.
</p>
</TabsContent>
<TabsContent value="monat">
<p className="text-sm text-muted-foreground">November · 18 Dienste sind noch offen.</p>
</TabsContent>
<TabsContent value="archiv">
<p className="text-sm text-muted-foreground">Abgeschlossene Monate einsehen.</p>
</TabsContent>
</Tabs>
);
}Barrierefreiheit
TabsListhat die Rolletablist, jeder Reiter die Rolletabund jeder Inhalt die Rolletabpanel. Die Zuordnung überaria-controls,aria-labelledbyundaria-selectedsetzt Radix automatisch.- Die Pfeiltasten wechseln zwischen den Reitern,
HomeundEndspringen zum ersten und letzten. Im Komponententest ist der Wechsel mitArrowRightabgesichert. - Jede
TabsListbraucht einen zugänglichen Namen überaria-label, etwa „Stationsansichten“. Ohne ihn findet ein Screenreader die Reihe nicht. - Ein gesperrter Reiter wird von der Tastatur übersprungen.
- Der Fokus ist über
focus-visiblesichtbar, hell wie dunkel. Der Komponententest prüft den offenen Zustand in beiden Themes ohne axe-Verstöße.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| defaultValue | string | – | Nein | The value of the tab to select by default, if uncontrolled |
| onValueChange | ((value: string) => void) | – | Nein | A function called when a new tab is selected |
| value | string | – | Nein | The value for the selected tab, if controlled |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| value | string | – | Nein | The value for the selected tab, if controlled |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| value | string | – | Nein | The value for the selected tab, if controlled |