Zum Inhalt springen
Dokumentation

Komponenten

Reiter (Tabs)

Stabil

Mehrere 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: value und onValueChange halten 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 Stepper zur Orientierung und Button fü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
Beispiel und Quelltext
station.tsx
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.

Beispiel und Quelltext
dienstplan.tsx
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

  • TabsList hat die Rolle tablist, jeder Reiter die Rolle tab und jeder Inhalt die Rolle tabpanel. Die Zuordnung über aria-controls, aria-labelledby und aria-selected setzt Radix automatisch.
  • Die Pfeiltasten wechseln zwischen den Reitern, Home und End springen zum ersten und letzten. Im Komponententest ist der Wechsel mit ArrowRight abgesichert.
  • Jede TabsList braucht einen zugänglichen Namen über aria-label, etwa „Stationsansichten“. Ohne ihn findet ein Screenreader die Reihe nicht.
  • Ein gesperrter Reiter wird von der Tastatur übersprungen.
  • Der Fokus ist über focus-visible sichtbar, hell wie dunkel. Der Komponententest prüft den offenen Zustand in beiden Themes ohne axe-Verstöße.

Props

Props von Tabs
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
defaultValuestring–NeinThe value of the tab to select by default, if uncontrolled
onValueChange((value: string) => void)–NeinA function called when a new tab is selected
valuestring–NeinThe value for the selected tab, if controlled
Props von TabsList
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von TabsTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
valuestring–NeinThe value for the selected tab, if controlled
Props von TabsContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
valuestring–NeinThe value for the selected tab, if controlled

Siehe auch