Zum Inhalt springen
Dokumentation

Komponenten

Datumsauswahl (DatePicker)

Stabil

Ein Datum oder einen Zeitraum wählen – getippt oder im Kalender, mit deutschem Format.

Die Datumsauswahl gibt es in drei Formen: DatePicker für einen Tag, DateRangePicker für einen Zeitraum und Calendar als reine Kalenderfläche. Alle drei zeigen deutsche Monatsnamen und beginnen die Woche am Montag.

Wann verwenden

  • Für ein einzelnes Datum wie den Tag einer Schicht oder den Stichtag einer Bettenbelegung.
  • Für einen Zeitraum, etwa eine Abwesenheit im Dienstplan.
  • Wenn Nutzer das Datum lieber tippen als klicken – die Eingabefelder nehmen TT.MM.JJJJ an.

Wann nicht

  • Für eine Uhrzeit ohne Datum nimm TimePicker.
  • Für einen Zeitraum über mehrere Monate ist eine Liste mit zwei Datumsfeldern übersichtlicher als ein Kalender.
  • Für historische Daten ohne Auswahlgrenzen kann ein einfaches Eingabefeld genügen.

Ein Datum

DatePicker verbindet ein Textfeld mit einem Kalender-Popover. value ist ein Date oder null; getippte Werte werden mit Enter und beim Verlassen des Feldes übernommen. Der Knopf mit dem Kalendersymbol trägt den Namen „Kalender öffnen“.

31.12.2026

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

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

function Datum() {
  const [datum, setDatum] = React.useState<Date | null>(new Date(2026, 11, 31));

  return (
    <div className="flex w-full max-w-sm flex-col gap-2">
      <Label htmlFor="schichtdatum">Datum der Schicht</Label>
      <DatePicker
        id="schichtdatum"
        value={datum}
        ariaLabel="Datum der Schicht"
        onValueChange={setDatum}
      />
      <p className="text-xs text-muted-foreground">
        {datum ? new Intl.DateTimeFormat("de-AT").format(datum) : "Kein Datum gewählt."}
      </p>
    </div>
  );
}

Ein Zeitraum

DateRangePicker führt zwei Felder für „Von“ und „Bis“. Der Wert ist ein Objekt { from, to }. Liegt das Ende vor dem Beginn, vertauscht die Komponente beide Werte beim Übernehmen.

Abwesenheit für die Dienstplanung erfassen – vertauschte Daten sortiert die Komponente automatisch.

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

import { DateRangePicker, type DateRangeValue } from "@neodin-eu/ui";

function Zeitraum() {
  const [zeitraum, setZeitraum] = React.useState<DateRangeValue>({
    from: new Date(2026, 11, 24),
    to: new Date(2027, 0, 1),
  });

  return (
    <div className="flex w-full max-w-md flex-col gap-2">
      <DateRangePicker
        value={zeitraum}
        ariaLabel="Zeitraum der Abwesenheit"
        onValueChange={setZeitraum}
      />
      <p className="text-xs text-muted-foreground">
        Abwesenheit für die Dienstplanung erfassen – vertauschte Daten sortiert die Komponente
        automatisch.
      </p>
    </div>
  );
}

Kalender

Calendar ist die Kalenderfläche allein – ohne Textfeld. Du steuerst sie über die Props von react-day-picker, etwa mode, selected und onSelect. Über disabled lassen sich Tage sperren, die nicht wählbar sind.

Dezember 2026

Gewählt: 15.12.2026

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

import { Calendar } from "@neodin-eu/ui";

function Kalender() {
  const [tag, setTag] = React.useState<Date | undefined>(new Date(2026, 11, 15));

  return (
    <div className="flex w-full max-w-sm flex-col gap-2">
      <div className="w-fit rounded-md border border-border bg-background">
        <Calendar
          mode="single"
          selected={tag}
          defaultMonth={new Date(2026, 11, 1)}
          today={new Date(2026, 11, 19)}
          showOutsideDays={false}
          onSelect={setTag}
        />
      </div>
      <p className="text-xs text-muted-foreground">
        {tag
          ? `Gewählt: ${new Intl.DateTimeFormat("de-AT").format(tag)}`
          : "Noch kein Tag gewählt."}
      </p>
    </div>
  );
}

Barrierefreiheit

  • Das Datumsfeld ist ein Textfeld mit dem Standardnamen „Datum“; ein unmögliches Datum wie „31.02.2026“ setzt aria-invalid und zeigt „Ungültiges Datum“, verbunden über aria-describedby. Das prüft der Komponententest.
  • min und max sperren Tage im Kalender und weisen getippte Daten außerhalb des Bereichs zurück. Beides ist im Komponententest abgesichert.
  • Im Zeitraum heißen die Felder „Von“ und „Bis“; vertauschte Daten werden automatisch sortiert.
  • Der Kalender zeigt deutsche Monatsnamen und beginnt die Woche mit Montag. Der Komponententest prüft beides.
  • Jeder Tag ist eine Schaltfläche mit vollem Datum als Namen, zum Beispiel „31. Dezember 2026“. Gesperrte Tage sind nicht bedienbar.
  • Alle drei Komponenten sind in hell und dunkel frei von axe-Verstößen.

Props

Props von DatePicker
PropTypStandardPflichtBeschreibung
ariaLabelstring–NeinAccessible name of the text field; defaults to the `date` catalog entry.
classNamestring–NeinAdditional classes for the wrapper element.
disabledboolean–NeinDisables the text field and calendar button.
idstring–NeinId assigned to the text field.
maxDate–NeinLatest selectable day; later days are disabled and rejected when typed.
minDate–NeinEarliest selectable day; earlier days are disabled and rejected when typed.
namestring–NeinName submitted with the text field.
onValueChange((value: Date | null) => void)–NeinCalled with the newly selected or typed date, or `null` when cleared.
placeholderstring–NeinPlaceholder of the text field; defaults to the locale date pattern.
valueDate | null–JaCurrently selected date, or `null` when empty.
Props von DateRangePicker
PropTypStandardPflichtBeschreibung
ariaLabelstring–NeinAccessible name of the group; defaults to the `dateRange` catalog entry.
classNamestring–NeinAdditional classes for the wrapper element.
disabledboolean–NeinDisables the text fields and calendar button.
maxDate–NeinLatest selectable day; later days are disabled and rejected when typed.
minDate–NeinEarliest selectable day; earlier days are disabled and rejected when typed.
onValueChange((value: DateRangeValue) => void)–NeinCalled with the newly selected or typed range.
placeholderstring–NeinPlaceholder of both text fields; defaults to the locale date pattern.
valueDateRangeValue–JaCurrently selected start and end date.

Calendar übernimmt die Props von react-day-picker; hier stehen die Ergänzungen der Bibliothek:

Props von Calendar
PropTypStandardPflichtBeschreibung
classNamestring–NeinClass name to add to the root element.
disabledMatcher | Matcher[]–NeinApply the `disabled` modifier to the matching days. Disabled days cannot be selected when in a selection mode is set.

Siehe auch