Zum Inhalt springen
Dokumentation

Komponenten

Formular (Form)

Stabil

Felder 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 Label und Input.
  • Für eine reine Suche, die bei jedem Tastendruck filtert, ist ein kontrolliertes Eingabefeld ohne Formular einfacher.
  • Für Einstellungen, die sofort gelten, passen Switch und Checkbox ohne 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.

Zum Beispiel der 14.11.2026.

Kurz und sachlich, ohne Namen von Patientinnen und Patienten.

Alle Felder sind Pflichtfelder.

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

  • FormControl setzt aria-invalid am Steuerelement. Der Komponententest prüft den Wechsel von false auf true, sobald eine Fehlermeldung erscheint.
  • FormMessage und FormDescription werden über aria-describedby mit 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 onSubmit wird nicht aufgerufen. Erst mit gültigen Werten kommt der Aufruf zustande.
  • Das native form-Element wird mit noValidate abgeschickt, 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.

Props von FormItem
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
requiredbooleanfalseNeinMarks the field as required and appends an asterisk to the label.
Props von FormLabel
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von FormControl
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
Props von FormMessage
PropTypStandardPflichtBeschreibung
classNamestring–Nein–

Siehe auch