Zum Inhalt springen
Dokumentation

Komponenten

Eingabefeld (Input)

Stabil

Eine Zeile Text erfassen – beschriftet, prüfbar und mit sichtbarem Zustand.

Ein Eingabefeld erfasst genau eine Zeile Text: eine Station, eine Personalnummer, einen Suchbegriff. Alles, was länger wird, gehört in einen Textbereich.

Wann verwenden

  • Für kurze Werte, die in eine Zeile passen, etwa „Station“ oder „Ticket“.
  • Für Suchfelder, die eine Liste filtern.
  • Für typisierte Eingaben wie type="email" oder type="number", wenn der Browser die passende Tastatur und Prüfung anbieten soll.

Wann nicht

  • Für mehrzeilige Notizen und Begründungen ist ein Textbereich richtig.
  • Für eine Auswahl aus festen Werten passen Select oder Combobox besser als ein freies Feld mit Tippfehlern.
  • Für ein Datum gehört die Datumsauswahl in den Vordergrund, nicht eine freie Texteingabe im Format TT.MM.JJJJ.

Beschriftung

Jedes Feld braucht eine sichtbare Beschriftung. Der Platzhalter ist kein Ersatz: Er verschwindet beim Tippen und wird von Screenreadern nicht als Name verwendet. Label und Input werden über htmlFor und id verbunden.

Zum Beispiel „Station 3“ oder „Notaufnahme“.

Beispiel und Quelltext
eingabe.tsx
import { Input, Label } from "@neodin-eu/ui";

function Eingabe() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-2">
      <Label htmlFor="station">Station</Label>
      <Input id="station" name="station" placeholder="Station 3" />
      <p className="text-xs text-muted-foreground">Zum Beispiel „Station 3“ oder „Notaufnahme“.</p>
    </div>
  );
}

Zustände

Ein fehlerhaftes Feld trägt aria-invalid, damit der Zustand auch für Screenreader gilt. Ein gesperrtes Feld ist zusätzlich über das native disabled-Attribut nicht bedienbar.

Bitte eine gültige Adresse eingeben.

Beispiel und Quelltext
zustaende.tsx
import { Input, Label } from "@neodin-eu/ui";

function Zustaende() {
  return (
    <div className="flex w-full max-w-sm flex-col gap-4">
      <div className="flex flex-col gap-2">
        <Label htmlFor="email">E-Mail</Label>
        <Input id="email" type="email" aria-invalid defaultValue="ungueltig" />
        <p className="text-xs text-destructive">Bitte eine gültige Adresse eingeben.</p>
      </div>
      <div className="flex flex-col gap-2">
        <Label htmlFor="personalnummer">Personalnummer</Label>
        <Input id="personalnummer" disabled defaultValue="1024" />
      </div>
    </div>
  );
}

Baukasten

Ändere den Platzhalter und sieh unten den passenden JSX-Code.

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

<Input />

Barrierefreiheit

  • Input rendert ein natives input-Element. Damit gelten die Tastaturregeln des Browsers; den sichtbaren Fokusring liefert die Komponente über focus-visible.
  • Der zugängliche Name kommt aus dem verbundenen Label. Ein Platzhalter allein reicht nicht.
  • aria-invalid wird unverändert weitergegeben und färbt Rahmen und Ring in der Fehlerfarbe – das ist im Komponententest abgesichert.
  • Ein Feld mit disabled ist nicht fokussierbar und wird nicht abgeschickt.

Props

Props von Input
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch