Komponenten
Eingabefeld (Input)
StabilEine 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"odertype="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
SelectoderComboboxbesser 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“.
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.
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.
import { Input } from "@neodin-eu/ui";
<Input />Barrierefreiheit
Inputrendert ein nativesinput-Element. Damit gelten die Tastaturregeln des Browsers; den sichtbaren Fokusring liefert die Komponente überfocus-visible.- Der zugängliche Name kommt aus dem verbundenen
Label. Ein Platzhalter allein reicht nicht. aria-invalidwird unverändert weitergegeben und färbt Rahmen und Ring in der Fehlerfarbe – das ist im Komponententest abgesichert.- Ein Feld mit
disabledist nicht fokussierbar und wird nicht abgeschickt.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |