Komponenten
Uhrzeit (TimePicker)
StabilEine Uhrzeit tippen oder aus Vorschlägen wählen – im 24-Stunden-Format.
Der TimePicker erfasst eine Uhrzeit als HH:mm. Du kannst sie direkt tippen
oder aus einer Vorschlagsliste im gewünschten Takt wählen – praktisch für
Schichtbeginn, Übergabezeiten und Termine.
Wann verwenden
- Für eine Uhrzeit am selben Tag, etwa den Beginn einer Schicht oder die Übergabe.
- Wenn feste Intervalle die Eingabe beschleunigen, zum Beispiel alle 15 oder 30 Minuten.
- Wenn neben der Auswahl auch eine krumme Uhrzeit wie „07:43“ möglich sein soll.
Wann nicht
- Für Datum und Uhrzeit zusammen ist
DatePickerplusTimePickerpassend; ein einzelnes Feld für beides gibt es nicht. - Für eine Dauer in Minuten oder Stunden nimm
NumberInput. - Für einen Zeitpunkt in einer anderen Zeitzone gehört die Zone sichtbar in die Beschriftung, nicht nur in den Wert.
Schichtbeginn
value hält die Uhrzeit als string im Format HH:mm oder null.
onValueChange meldet jede bestätigte Änderung. Mit einem Startwert zeigt das
Feld sofort die geplante Zeit.
Beginn um 06:00 Uhr.
schichtbeginn.tsx
import * as React from "react";
import { Label, TimePicker } from "@neodin-eu/ui";
function Schichtbeginn() {
const [zeit, setZeit] = React.useState<string | null>("06:00");
return (
<div className="flex w-full max-w-xs flex-col gap-2">
<Label htmlFor="schichtbeginn">Beginn der Schicht</Label>
<TimePicker
id="schichtbeginn"
value={zeit}
ariaLabel="Beginn der Schicht"
onValueChange={setZeit}
/>
<p className="text-xs text-muted-foreground">
{zeit ? `Beginn um ${zeit} Uhr.` : "Noch keine Uhrzeit gewählt."}
</p>
</div>
);
}Vorschläge im Halbstundentakt
step bestimmt den Abstand der Vorschläge in Minuten; der Standard sind 15
Minuten. Die Liste enthält damit 96 Einträge pro Tag. Eine getippte Uhrzeit
außerhalb des Takts bleibt gültig.
Vorschläge im Halbstundentakt – jede Uhrzeit lässt sich auch tippen.
uebergabe.tsx
import * as React from "react";
import { Label, TimePicker } from "@neodin-eu/ui";
function Uebergabe() {
const [zeit, setZeit] = React.useState<string | null>(null);
return (
<div className="flex w-full max-w-xs flex-col gap-2">
<Label htmlFor="uebergabezeit">Übergabezeit</Label>
<TimePicker
id="uebergabezeit"
value={zeit}
step={30}
ariaLabel="Übergabezeit"
placeholder="HH:mm"
onValueChange={setZeit}
/>
<p className="text-xs text-muted-foreground">
Vorschläge im Halbstundentakt – jede Uhrzeit lässt sich auch tippen.
</p>
</div>
);
}Barrierefreiheit
- Das Eingabefeld hat die Rolle
comboboxund heißt ohne eigene Vorgabe „Uhrzeit“; überariaLabelbekommt es einen passenden Namen. - Die Vorschläge bilden eine Listbox: Jede Uhrzeit ist eine Option und lässt sich mit einem Klick übernehmen. Der Komponententest prüft die Auswahl.
- Eine getippte Uhrzeit wird mit
Enterübernommen. Das ist im Komponententest abgesichert. - Eine unmögliche Uhrzeit wie „25:00“ setzt
aria-invalidund zeigt die Meldung „Ungültige Uhrzeit“, die überaria-describedbyverbunden ist. - Das Feld ist 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 `time` catalog entry. |
| className | string | – | Nein | Additional classes for the wrapper element. |
| disabled | boolean | – | Nein | Disables the text field and suggestion list. |
| id | string | – | Nein | Id assigned to the text field. |
| name | string | – | Nein | Name submitted with the text field. |
| onValueChange | ((value: string | null) => void) | – | Nein | Called with the newly selected or typed time, or `null` when cleared. |
| placeholder | string | HH:mm | Nein | Placeholder of the text field; defaults to `"HH:mm"`. |
| step | number | 15 | Nein | Interval of the suggested list in minutes. |
| value | string | null | – | Ja | Time as `HH:mm`, or `null` when empty. |