Komponenten
Zahlenfeld (NumberInput)
StabilDezimalzahlen erfassen – gruppiert angezeigt, beim Bearbeiten roh und mit Grenzen.
Ein Zahlenfeld erfasst einen numerischen Wert: belegte Betten, Pflegestunden, eine Menge Material. Solange das Feld nicht fokussiert ist, zeigt es die Zahl in der Sprache der Anwendung – mit Tausenderpunkt und Dezimalkomma. Beim Bearbeiten steht der Wert ohne Gruppierung da.
Wann verwenden
- Für Mengen und Messwerte, die als Zahl weiterverarbeitet werden, etwa die Bettenbelegung einer Station.
- Für Dezimalwerte wie Pflegestunden oder Materialmengen, die in Schritten erhöht werden sollen.
- Wenn ein gültiger Bereich gilt:
minundmaxhalten den Wert in seinen Grenzen.
Wann nicht
- Für Text, der nur wie eine Zahl aussieht – eine Zimmernummer oder Personalnummer – ist ein Eingabefeld richtig. Führende Nullen und Buchstaben bleiben dort erhalten.
- Für Geldbeträge mit eigener Währungsanzeige passt ein spezialisiertes Feld besser als ein freies Zahlenfeld.
- Für einen Code aus mehreren Ziffern, etwa einen Einmalcode, gibt es
InputOTP.
Eingabe und Anzeige
Der Wert ist kontrolliert: value und onValueChange gehören zusammen. Ohne
Fokus zeigt das Feld die formatierte Zahl, mit Fokus den bearbeitbaren Wert.
Ein leerer Wert wird als null gemeldet.
42 von 200 Betten belegt.
import * as React from "react";
import { Label, NumberInput } from "@neodin-eu/ui";
function Belegung() {
const [belegt, setBelegt] = React.useState<number | null>(42);
return (
<div className="flex w-full max-w-xs flex-col gap-2">
<Label htmlFor="belegte-betten">Belegte Betten</Label>
<NumberInput
id="belegte-betten"
name="belegte-betten"
value={belegt}
onValueChange={setBelegt}
min={0}
max={200}
step={1}
/>
<p className="text-xs text-muted-foreground">
{belegt === null ? "Keine Angabe" : `${belegt} von 200 Betten belegt.`}
</p>
</div>
);
}Schritte und Grenzen
step bestimmt, um wie viel die Pfeiltasten den Wert ändern. min und max
begrenzen ihn; beim Verlassen des Feldes wird ein Wert außerhalb des Bereichs
auf die nächste Grenze gesetzt. Ein Dezimalkomma wird in der Sprache der
Anwendung verstanden.
38.5 Stunden, in halben Schritten änderbar.
import * as React from "react";
import { Label, NumberInput } from "@neodin-eu/ui";
function Stunden() {
const [stunden, setStunden] = React.useState<number | null>(38.5);
return (
<div className="flex w-full max-w-xs flex-col gap-2">
<Label htmlFor="pflegestunden">Pflegestunden pro Woche</Label>
<NumberInput
id="pflegestunden"
name="pflegestunden"
value={stunden}
onValueChange={setStunden}
min={0}
max={60}
step={0.5}
/>
<p className="text-xs text-muted-foreground">
{stunden === null ? "Keine Angabe" : `${stunden} Stunden, in halben Schritten änderbar.`}
</p>
</div>
);
}Barrierefreiheit
NumberInputrendert ein nativesinput-Element mitinputMode="decimal", damit mobile Geräte die Zifferntastatur anbieten.ArrowUperhöht den Wert umstep,ArrowDownsenkt ihn; das ist im Komponententest abgesichert.- Beim Verlassen des Feldes wird der Wert auf
minundmaxbegrenzt und wieder in der Sprache der Anwendung angezeigt. Auch das prüft der Komponententest. - Der zugängliche Name kommt aus der verbundenen
Label-Beschriftung. Ein Platzhalter allein reicht nicht. - Das Feld ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| max | number | – | Nein | Upper bound; larger values are clamped on blur and arrow keys. |
| min | number | – | Nein | Lower bound; smaller values are clamped on blur and arrow keys. |
| onValueChange | ((value: number | null) => void) | – | Nein | Called with the parsed value, or `null` when the field is cleared. |
| step | number | 1 | Nein | Increment used by the arrow keys; defaults to `1`. |
| value | number | null | – | Ja | Current numeric value, or `null` when empty. |