Komponenten
Datumsauswahl (DatePicker)
StabilEin 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.JJJJan.
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
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.
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.
| Mo | Di | Mi | Do | Fr | Sa | So |
|---|---|---|---|---|---|---|
Gewählt: 15.12.2026
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-invalidund zeigt „Ungültiges Datum“, verbunden überaria-describedby. Das prüft der Komponententest. minundmaxsperren 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| ariaLabel | string | – | Nein | Accessible name of the text field; defaults to the `date` catalog entry. |
| className | string | – | Nein | Additional classes for the wrapper element. |
| disabled | boolean | – | Nein | Disables the text field and calendar button. |
| id | string | – | Nein | Id assigned to the text field. |
| max | Date | – | Nein | Latest selectable day; later days are disabled and rejected when typed. |
| min | Date | – | Nein | Earliest selectable day; earlier days are disabled and rejected when typed. |
| name | string | – | Nein | Name submitted with the text field. |
| onValueChange | ((value: Date | null) => void) | – | Nein | Called with the newly selected or typed date, or `null` when cleared. |
| placeholder | string | – | Nein | Placeholder of the text field; defaults to the locale date pattern. |
| value | Date | null | – | Ja | Currently selected date, or `null` when empty. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| ariaLabel | string | – | Nein | Accessible name of the group; defaults to the `dateRange` catalog entry. |
| className | string | – | Nein | Additional classes for the wrapper element. |
| disabled | boolean | – | Nein | Disables the text fields and calendar button. |
| max | Date | – | Nein | Latest selectable day; later days are disabled and rejected when typed. |
| min | Date | – | Nein | Earliest selectable day; earlier days are disabled and rejected when typed. |
| onValueChange | ((value: DateRangeValue) => void) | – | Nein | Called with the newly selected or typed range. |
| placeholder | string | – | Nein | Placeholder of both text fields; defaults to the locale date pattern. |
| value | DateRangeValue | – | Ja | Currently selected start and end date. |
Calendar übernimmt die Props von react-day-picker; hier stehen die
Ergänzungen der Bibliothek:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | Class name to add to the root element. |
| disabled | Matcher | Matcher[] | – | Nein | Apply the `disabled` modifier to the matching days. Disabled days cannot be selected when in a selection mode is set. |