Zum Inhalt springen
Dokumentation

Komponenten

Zahlenfeld (NumberInput)

Stabil

Dezimalzahlen 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: min und max halten 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.

Beispiel und Quelltext
belegung.tsx
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.

Beispiel und Quelltext
stunden.tsx
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

  • NumberInput rendert ein natives input-Element mit inputMode="decimal", damit mobile Geräte die Zifferntastatur anbieten.
  • ArrowUp erhöht den Wert um step, ArrowDown senkt ihn; das ist im Komponententest abgesichert.
  • Beim Verlassen des Feldes wird der Wert auf min und max begrenzt 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

Props von NumberInput
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–Nein–
maxnumber–NeinUpper bound; larger values are clamped on blur and arrow keys.
minnumber–NeinLower bound; smaller values are clamped on blur and arrow keys.
onValueChange((value: number | null) => void)–NeinCalled with the parsed value, or `null` when the field is cleared.
stepnumber1NeinIncrement used by the arrow keys; defaults to `1`.
valuenumber | null–JaCurrent numeric value, or `null` when empty.

Siehe auch