Zum Inhalt springen
Dokumentation

Komponenten

Optionsgruppe (RadioGroup)

Stabil

Genau eine von wenigen Möglichkeiten wählen – alle Optionen bleiben sichtbar.

Eine Optionsgruppe lässt genau einen Wert aus einer kurzen Liste wählen. Alle Möglichkeiten bleiben sichtbar, damit du sie vergleichen kannst – etwa die Schicht für einen Dienstplan.

Wann verwenden

  • Wenn genau eine von zwei bis fünf Möglichkeiten gelten darf.
  • Wenn die Optionen kurz sind und nebeneinander oder untereinander Platz haben.
  • Wenn die Wahl im Formular erst beim Absenden gilt und nicht sofort wirken soll.

Wann nicht

  • Für eine lange Liste ist eine Auswahl mit Klappliste übersichtlicher.
  • Für mehrere gleichzeitig gültige Werte nimm Kontrollkästchen.
  • Für eine Einstellung, die sofort wirkt, ist ein Schalter die richtige Form.

Aufbau

RadioGroup hält den Wert, RadioGroupItem steht für eine Möglichkeit. Jeder Eintrag bekommt eine eigene Beschriftung über Label und id.

Beispiel und Quelltext
schicht.tsx
import * as React from "react";

import { Label, RadioGroup, RadioGroupItem } from "@neodin-eu/ui";

const schichten = [
  { value: "frueh", label: "Frühschicht (06:00–14:00)" },
  { value: "spaet", label: "Spätschicht (14:00–22:00)" },
  { value: "nacht", label: "Nachtschicht (22:00–06:00)" },
];

function Schicht() {
  const [schicht, setSchicht] = React.useState("frueh");

  return (
    <RadioGroup value={schicht} onValueChange={setSchicht} aria-label="Schicht">
      {schichten.map(({ value, label }) => (
        <div key={value} className="flex items-center gap-2">
          <RadioGroupItem value={value} id={`schicht-${value}`} />
          <Label htmlFor={`schicht-${value}`}>{label}</Label>
        </div>
      ))}
    </RadioGroup>
  );
}

Zustände

Ein einzelner Eintrag lässt sich sperren, etwa wenn eine Schicht ausgebucht ist. Mit disabled auf der Gruppe ist keine Auswahl mehr möglich.

Beispiel und Quelltext
zustaende.tsx
import { Label, RadioGroup, RadioGroupItem } from "@neodin-eu/ui";

function Zustaende() {
  return (
    <div className="flex flex-col gap-4">
      <RadioGroup defaultValue="station" aria-label="Zuweisung">
        <div className="flex items-center gap-2">
          <RadioGroupItem value="station" id="zuweisung-station" />
          <Label htmlFor="zuweisung-station">Station</Label>
        </div>
        <div className="flex items-center gap-2">
          <RadioGroupItem value="ambulanz" id="zuweisung-ambulanz" disabled />
          <Label htmlFor="zuweisung-ambulanz">Ambulanz (ausgebucht)</Label>
        </div>
      </RadioGroup>
      <RadioGroup defaultValue="standard" aria-label="Tarif" disabled>
        <div className="flex items-center gap-2">
          <RadioGroupItem value="standard" id="tarif-standard" />
          <Label htmlFor="tarif-standard">Standard</Label>
        </div>
        <div className="flex items-center gap-2">
          <RadioGroupItem value="pro" id="tarif-pro" />
          <Label htmlFor="tarif-pro">Pro</Label>
        </div>
      </RadioGroup>
    </div>
  );
}

Barrierefreiheit

  • RadioGroup rendert über Radix eine Gruppe mit der Rolle radiogroup, jeder Eintrag hat die Rolle radio. Der zugängliche Name kommt aus der Beschriftung oder aus aria-label auf der Gruppe.
  • Tab führt in die Gruppe zum gewählten Eintrag. Die Pfeiltasten nach oben und unten wechseln Fokus und Auswahl und laufen am Rand um; die Leertaste wählt den fokussierten Eintrag. Beides ist im Komponententest abgesichert.
  • Gesperrte Einträge werden übersprungen und lassen sich nicht wählen.
  • Die Gruppe ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von RadioGroup
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
defaultValuestring–Nein–
disabledboolean–Nein–
onValueChange((value: string) => void)–Nein–
valuestring | null–Nein–

Jeder Eintrag trägt den Wert und seinen Zustand:

Props von RadioGroupItem
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
valuestring | null–Nein–

Siehe auch