Komponenten
Optionsgruppe (RadioGroup)
StabilGenau 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.
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.
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
RadioGrouprendert über Radix eine Gruppe mit der Rolleradiogroup, jeder Eintrag hat die Rolleradio. Der zugängliche Name kommt aus der Beschriftung oder ausaria-labelauf der Gruppe.Tabführt in die Gruppe zum gewählten Eintrag. Die Pfeiltasten nach oben und unten wechseln Fokus und Auswahl und laufen am Rand um; dieLeertastewä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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| defaultValue | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| onValueChange | ((value: string) => void) | – | Nein | – |
| value | string | null | – | Nein | – |
Jeder Eintrag trägt den Wert und seinen Zustand:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| value | string | null | – | Nein | – |