Zum Inhalt springen
Dokumentation

Muster

Formular mit Validierung

Stabil

Ein Formular für Abwesenheiten: Feldprüfung mit Zod, deutsche Meldungen und eine Bestätigung nach dem Absenden.

Dieses Muster zeigt ein vollständiges Formular: Name, Station, erster Tag und Grund. Es verbindet Form mit Input, Select, DatePicker, Textarea und Button. Die Prüfung steht in einem Zod-Schema, die Meldungen sind deutsch, und nach dem Absenden erscheint eine Bestätigung.

Warum diese Kombination

Form reicht den Formularzustand von react-hook-form an alle Felder weiter. Jedes Feld steckt in FormField und FormItem; daraus ziehen FormLabel, FormControl und FormMessage dieselbe id. Dadurch zeigt jede Meldung am richtigen Feld, und Screenreader verbinden Beschriftung, Beschreibung und Fehlertext. Die Eingabebausteine selbst bleiben unverändert: Input nimmt Text, Select eine feste Liste, DatePicker ein Date und Textarea den freien Grund. Button sendet das Formular ab.

Das Beispiel

Zum Beispiel der 14.12.2026.

Ohne Namen von Patientinnen und Patienten, ohne Diagnosen.

Alle Felder sind Pflichtfelder.

Beispiel und Quelltext
formular-mit-validierung.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,
  DatePicker,
  Form,
  FormControl,
  FormDescription,
  FormField,
  FormItem,
  FormLabel,
  FormMessage,
  Input,
  Select,
  SelectContent,
  SelectItem,
  SelectTrigger,
  SelectValue,
  Textarea,
} from "@neodin-eu/ui";

const stationen = [
  { value: "station-1", label: "Station 1" },
  { value: "station-2", label: "Station 2" },
  { value: "station-3", label: "Station 3" },
  { value: "intensiv", label: "Intensivstation" },
];

const schema = z.object({
  name: z.string().trim().min(2, "Bitte gib den Namen der Person an."),
  station: z.string().min(1, "Bitte wähle eine Station."),
  tag: z.date("Bitte wähle den ersten Tag der Abwesenheit."),
  grund: z.string().trim().min(10, "Bitte beschreibe den Grund in mindestens zehn Zeichen."),
});

type FormValues = z.infer<typeof schema>;

function FormularMitValidierung() {
  const [bestaetigung, setBestaetigung] = React.useState<string | null>(null);
  const form = useForm<FormValues>({
    resolver: zodResolver(schema),
    defaultValues: { name: "", station: "", tag: undefined, grund: "" },
  });

  function absenden(values: FormValues) {
    const station = stationen.find((eintrag) => eintrag.value === values.station);
    const datum = new Intl.DateTimeFormat("de-AT", {
      day: "2-digit",
      month: "long",
      year: "numeric",
    }).format(values.tag);

    setBestaetigung(
      `Die Abwesenheit von ${values.name} auf ${station?.label ?? values.station} ab ${datum} ist bei der Stationsleitung gemeldet.`,
    );
    form.reset();
  }

  return (
    <Form {...form}>
      <form
        onSubmit={form.handleSubmit(absenden, () => setBestaetigung(null))}
        noValidate
        className="flex w-full max-w-md flex-col gap-5"
      >
        <FormField
          control={form.control}
          name="name"
          render={({ field }) => (
            <FormItem required>
              <FormLabel>Name</FormLabel>
              <FormControl>
                <Input placeholder="Vor- und Nachname" autoComplete="name" {...field} />
              </FormControl>
              <FormMessage />
            </FormItem>
          )}
        />
        <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="tag"
          render={({ field }) => (
            <FormItem required>
              <FormLabel>Erster Tag</FormLabel>
              <FormControl>
                <DatePicker
                  value={field.value ?? null}
                  onValueChange={field.onChange}
                  ariaLabel="Erster Tag"
                />
              </FormControl>
              <FormDescription>Zum Beispiel der 14.12.2026.</FormDescription>
              <FormMessage />
            </FormItem>
          )}
        />
        <FormField
          control={form.control}
          name="grund"
          render={({ field }) => (
            <FormItem required>
              <FormLabel>Grund</FormLabel>
              <FormControl>
                <Textarea rows={3} placeholder="Kurz und sachlich" {...field} />
              </FormControl>
              <FormDescription>
                Ohne Namen von Patientinnen und Patienten, ohne Diagnosen.
              </FormDescription>
              <FormMessage />
            </FormItem>
          )}
        />
        <div className="flex items-center gap-3">
          <Button type="submit">Abwesenheit melden</Button>
          <p className="text-xs text-muted-foreground">Alle Felder sind Pflichtfelder.</p>
        </div>
        {bestaetigung ? (
          <Alert variant="success">
            <AlertTitle>Abwesenheit gemeldet</AlertTitle>
            <AlertDescription>{bestaetigung}</AlertDescription>
          </Alert>
        ) : null}
      </form>
    </Form>
  );
}

Prüfung mit Zod

Das Schema ist die einzige Stelle, an der die Regeln stehen:

  • Der Name braucht mindestens zwei Zeichen.
  • Die Station darf nicht leer sein.
  • Der erste Tag ist ein Date; DatePicker liefert null, solange nichts gewählt ist, deshalb meldet z.date() hier „Bitte wähle den ersten Tag der Abwesenheit.“
  • Der Grund braucht mindestens zehn Zeichen.

zodResolver verbindet das Schema mit react-hook-form. noValidate am form-Element schaltet die Browser-Prüfung ab, damit nur die deutschen Meldungen aus dem Schema erscheinen. FormMessage liest den Fehler des Feldes und rendert ihn als Text mit id; FormControl setzt aria-describedby auf genau diese id, sobald ein Fehler vorliegt.

Absenden und Bestätigung

Button mit type="submit" löst form.handleSubmit aus. Sind alle Felder gültig, formatiert das Beispiel das Datum mit Intl.DateTimeFormat("de-AT") und zeigt eine Alert mit variant="success". Erfolgsmeldungen tragen die Rolle status und werden von Screenreadern höflich angesagt. Danach setzt form.reset() die Felder zurück. Schlägt die Prüfung fehl, verschwindet eine alte Bestätigung, damit sie nicht zu den neuen Meldungen passt.

Ein Alert ist hier bewusst gewählt: Die Bestätigung gehört zum Formular und soll stehen bleiben. Eine Einblendung (toast) wäre für einen kurzen Hinweis richtig, etwa nach dem Kopieren eines Werts.

Was du anpasst

  • Regeln und Texte im Zod-Schema; jede Meldung benennt den nächsten Schritt.
  • Die Stationsliste als Konstante oder aus deiner Anwendung.
  • defaultValues: Für DatePicker ist das Feld zu Beginn undefined; der Baustein zeigt dann ein leeres Feld und gibt null zurück.
  • Die Erfolgsmeldung: Sie nennt Station und Datum, aber keine Personendaten aus der Pflege.

Siehe auch