Komponenten
Formular (Form)
StabilFelder mit Beschriftung, Hinweis und Fehlermeldung verbinden – mit react-hook-form und Zod.
Ein Formular bündelt mehrere Felder zu einer Aufgabe: eine Schicht tauschen,
ein Ticket anlegen, eine Übergabe bestätigen. Die Teile von Form verbinden
jedes Feld mit seiner Beschriftung, seinem Hinweis und seiner Fehlermeldung –
für alle sichtbar und für Screenreader hörbar.
Wann verwenden
- Sobald ein Formular mehr als ein Feld hat und Werte geprüft werden müssen, etwa beim Tausch einer Schicht.
- Wenn Fehlermeldungen in deutscher Sprache direkt am Feld stehen sollen.
- Wenn die Prüfung im Browser dieselbe sein soll wie im Code – hier mit Zod
und
react-hook-form.
Wann nicht
- Für ein einzelnes Feld ohne Prüfung genügen
LabelundInput. - Für eine reine Suche, die bei jedem Tastendruck filtert, ist ein kontrolliertes Eingabefeld ohne Formular einfacher.
- Für Einstellungen, die sofort gelten, passen
SwitchundCheckboxohne Absenden-Schritt besser.
Aufbau und Validierung
Form reicht die Methoden von react-hook-form weiter. FormField verbindet
ein Feld über control und name mit dem Formular, FormItem gruppiert
Beschriftung, Steuerelement und Meldung. FormLabel, FormControl,
FormDescription und FormMessage ziehen ihre IDs aus diesem Zusammenhang –
du musst sie nicht selbst verdrahten.
Das Beispiel prüft drei Pflichtfelder: Station, Datum und Begründung. Die Meldungen erscheinen nach dem Absenden am jeweiligen Feld, in deutscher Sprache. Erst wenn alle Werte gültig sind, erscheint die Bestätigung.
import { zodResolver } from "@hookform/resolvers/zod";
import * as React from "react";
import { useForm } from "react-hook-form";
import { z } from "zod";
import {
Alert,
AlertDescription,
AlertTitle,
Button,
Form,
FormControl,
FormDescription,
FormField,
FormItem,
FormLabel,
FormMessage,
Input,
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
Textarea,
} from "@neodin-eu/ui";
const stationen = [
{ value: "notaufnahme", label: "Notaufnahme" },
{ value: "innere", label: "Innere Medizin" },
{ value: "chirurgie", label: "Chirurgie" },
{ value: "intensiv", label: "Intensivstation" },
];
const schema = z.object({
station: z.string().min(1, "Bitte wähle eine Station."),
datum: z.string().min(1, "Bitte gib das Datum der Schicht an."),
begruendung: z.string().min(10, "Bitte beschreibe den Grund in mindestens zehn Zeichen."),
});
type FormValues = z.infer<typeof schema>;
function SchichtTauschen() {
const [bestaetigung, setBestaetigung] = React.useState<string | null>(null);
const form = useForm<FormValues>({
resolver: zodResolver(schema),
defaultValues: { station: "", datum: "", begruendung: "" },
});
function absenden(values: FormValues) {
const station = stationen.find((eintrag) => eintrag.value === values.station);
const datum = new Intl.DateTimeFormat("de-AT").format(new Date(`${values.datum}T00:00:00`));
setBestaetigung(
`Die Tauschanfrage für ${station?.label ?? values.station} am ${datum} liegt beim Dienstplan.`,
);
form.reset();
}
return (
<Form {...form}>
<form
onSubmit={form.handleSubmit(absenden)}
noValidate
className="flex w-full max-w-md flex-col gap-5"
>
<FormField
control={form.control}
name="station"
render={({ field }) => (
<FormItem required>
<FormLabel>Station</FormLabel>
<Select value={field.value} onValueChange={field.onChange}>
<FormControl>
<SelectTrigger className="w-full" onBlur={field.onBlur}>
<SelectValue placeholder="Station wählen" />
</SelectTrigger>
</FormControl>
<SelectContent>
{stationen.map(({ value, label }) => (
<SelectItem key={value} value={value}>
{label}
</SelectItem>
))}
</SelectContent>
</Select>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="datum"
render={({ field }) => (
<FormItem required>
<FormLabel>Datum der Schicht</FormLabel>
<FormControl>
<Input type="date" {...field} />
</FormControl>
<FormDescription>Zum Beispiel der 14.11.2026.</FormDescription>
<FormMessage />
</FormItem>
)}
/>
<FormField
control={form.control}
name="begruendung"
render={({ field }) => (
<FormItem required>
<FormLabel>Begründung</FormLabel>
<FormControl>
<Textarea rows={4} placeholder="Warum passt die Schicht nicht?" {...field} />
</FormControl>
<FormDescription>
Kurz und sachlich, ohne Namen von Patientinnen und Patienten.
</FormDescription>
<FormMessage />
</FormItem>
)}
/>
<div className="flex items-center gap-3">
<Button type="submit">Tausch anfragen</Button>
<p className="text-xs text-muted-foreground">Alle Felder sind Pflichtfelder.</p>
</div>
{bestaetigung ? (
<Alert variant="success">
<AlertTitle>Anfrage eingereicht</AlertTitle>
<AlertDescription>{bestaetigung}</AlertDescription>
</Alert>
) : null}
</form>
</Form>
);
}Barrierefreiheit
FormControlsetztaria-invalidam Steuerelement. Der Komponententest prüft den Wechsel vonfalseauftrue, sobald eine Fehlermeldung erscheint.FormMessageundFormDescriptionwerden überaria-describedbymit dem Feld verbunden. Der Test liest beide Texte zusammen als zugängliche Beschreibung.- Ein Pflichtfeld zeigt einen Stern, der für Screenreader ausgeblendet ist, und den versteckten Text „Pflichtfeld“. Der zugängliche Name enthält ihn – im Test „E-Mail Pflichtfeld“.
- Nach einem leeren Absenden erscheint die Meldung, und
onSubmitwird nicht aufgerufen. Erst mit gültigen Werten kommt der Aufruf zustande. - Das native
form-Element wird mitnoValidateabgeschickt, damit die deutschen Meldungen der Anwendung erscheinen und nicht die Sprechblasen des Browsers. - Das Formular ist in hell und dunkel frei von axe-Verstößen – auch mit sichtbarer Fehlermeldung.
Props
Form ist der FormProvider von react-hook-form und hat keine eigenen
Props. Die Tabellen unten beschreiben die Teile, die du beim Bau eines Feldes
verwendest. FormField nimmt zusätzlich control, name und render aus
react-hook-form entgegen.
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| required | boolean | false | Nein | Marks the field as required and appends an asterisk to the label. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |