Komponenten
Einmalcode (InputOTP)
StabilEinen Code aus Ziffern in einzelnen Kästchen erfassen – tippen oder einfügen.
Ein Einmalcode ist kurz, zählt nur einmal und wird oft aus einer anderen App abgeschrieben. Die Kästchen zeigen jede Ziffer einzeln, damit du den Code leicht mit der Anzeige vergleichen kannst.
Wann verwenden
- Für Bestätigungscodes aus einer Authenticator-App oder per Nachricht.
- Für kurze PINs, etwa am Stationsgerät oder für eine Freigabe.
- Wenn Nutzer den Code häufig einfügen statt ihn abzutippen.
Wann nicht
- Für Passwörter jeder Länge ist
PasswordInputrichtig. - Für längere Zeichenketten mit Buchstaben und Ziffern ist ein normales Eingabefeld geeigneter.
- Für eine Zahl, mit der weitergerechnet wird – etwa eine Menge – nimm
NumberInput.
Bestätigungscode
InputOTP hält den Wert, InputOTPGroup fasst Kästchen zusammen,
InputOTPSlot zeigt eine Position und InputOTPSeparator trennt Gruppen. Die
Gruppierung von drei und drei Ziffern entspricht der Anzeige in vielen
Authenticator-Apps.
Sechs Ziffern aus der Authenticator-App; der Code läuft nach fünf Minuten ab.
import * as React from "react";
import { InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Label } from "@neodin-eu/ui";
function Bestaetigung() {
const [code, setCode] = React.useState("");
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="einmalcode">Einmalcode aus der App</Label>
<InputOTP
id="einmalcode"
maxLength={6}
value={code}
onChange={setCode}
aria-describedby="einmalcode-hinweis"
>
<InputOTPGroup>
<InputOTPSlot index={0} />
<InputOTPSlot index={1} />
<InputOTPSlot index={2} />
</InputOTPGroup>
<InputOTPSeparator />
<InputOTPGroup>
<InputOTPSlot index={3} />
<InputOTPSlot index={4} />
<InputOTPSlot index={5} />
</InputOTPGroup>
</InputOTP>
<p id="einmalcode-hinweis" className="text-xs text-muted-foreground">
Sechs Ziffern aus der Authenticator-App; der Code läuft nach fünf Minuten ab.
</p>
</div>
);
}PIN
Ohne Trenner und mit vier Stellen entsteht aus denselben Teilen ein PIN-Feld.
maxLength am InputOTP muss zur Anzahl der Slots passen.
Vier Ziffern, gemeinsam am Stationsplatz genutzt.
import * as React from "react";
import { InputOTP, InputOTPGroup, InputOTPSlot, Label } from "@neodin-eu/ui";
function Pin() {
const [pin, setPin] = React.useState("");
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="geraete-pin">PIN des Stationsgeräts</Label>
<InputOTP
id="geraete-pin"
maxLength={4}
value={pin}
onChange={setPin}
aria-describedby="geraete-pin-hinweis"
>
<InputOTPGroup>
<InputOTPSlot index={0} />
<InputOTPSlot index={1} />
<InputOTPSlot index={2} />
<InputOTPSlot index={3} />
</InputOTPGroup>
</InputOTP>
<p id="geraete-pin-hinweis" className="text-xs text-muted-foreground">
Vier Ziffern, gemeinsam am Stationsplatz genutzt.
</p>
</div>
);
}Barrierefreiheit
- Die Eingabe erfolgt in einem einzigen nativen Eingabefeld; die Kästchen
zeigen nur die Zeichen an. Der zugängliche Name kommt aus der verbundenen
Beschriftung oder einem
aria-label. - Ein eingefügter sechsstelliger Code füllt alle Kästchen. Das ist im Komponententest abgesichert.
InputOTPSeparatorträgt die Rolleseparator; der Komponententest findet ihn über diese Rolle.- Die Kästchen zeigen den aktiven Slot über
data-activean; der sichtbare Fokusring bleibt auch im Dunkelmodus erhalten. - Das Feld ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| value | string | – | Nein | – |
Ein Kästchen erhält seine Position über index:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| index | number | – | Ja | Zero-based position of the slot within the OTP input. |