Zum Inhalt springen
Dokumentation

Komponenten

Einmalcode (InputOTP)

Stabil

Einen 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 PasswordInput richtig.
  • 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.

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

Beispiel und Quelltext
pin.tsx
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.
  • InputOTPSeparator trägt die Rolle separator; der Komponententest findet ihn über diese Rolle.
  • Die Kästchen zeigen den aktiven Slot über data-active an; der sichtbare Fokusring bleibt auch im Dunkelmodus erhalten.
  • Das Feld ist in hell und dunkel frei von axe-Verstößen.

Props

Props von InputOTP
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
disabledboolean–Nein–
valuestring–Nein–

Ein Kästchen erhält seine Position über index:

Props von InputOTPSlot
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
indexnumber–JaZero-based position of the slot within the OTP input.

Siehe auch