Zum Inhalt springen

Dokumentation

Komponenten

Verification Inputs

Eingabe von Sicherheitscodes mit einzelnen Feldern pro Zeichen.

Verwendung

Ein Verification Input erfasst kurze Codes, zum Beispiel aus einer SMS oder E-Mail. Der Fokus springt automatisch weiter, Einfügen verteilt den Code auf alle Felder.

Standard mit vier Stellen

Das ist ein Hinweistext.

blade
<gedisa:otp label="Sicherheitscode" description="Das ist ein Hinweistext." />

Größen

Drei Größen mit 64px, 80px und 96px pro Feld. Der Standard ist md.

Small, Medium und Large
blade
<gedisa:otp size="sm" label="Small" />
<gedisa:otp size="md" label="Medium" />
<gedisa:otp size="lg" label="Large" />

Länge und Trenner

length legt die Anzahl der Stellen fest. Bei sechs Stellen wird automatisch ein Trenner eingefügt, separator schaltet ihn gezielt an oder aus.

Sechs Stellen mit Trenner
blade
<gedisa:otp size="sm" length="6" label="Sicherheitscode" />

Validierung

Mit wire:model.live wird der Code bei jeder Eingabe an Livewire übertragen. Das Beispiel prüft den vollständigen Code, der gültige Demo-Code ist 123456.

Live-Prüfung

Gib den Code aus der E-Mail ein.

blade
<gedisa:otp wire:model.live="code" size="sm" length="6" label="Sicherheitscode" :description="$verified ? 'Code bestätigt.' : 'Gib den Code aus der E-Mail ein.'" />

Zustände

disabled sperrt alle Felder, error markiert sie und zeigt eine Fehlermeldung.

Deaktiviert und Fehler
blade
<gedisa:otp size="sm" label="Deaktiviert" disabled />
<gedisa:otp size="sm" label="Fehler" error="Der Code ist ungültig." />

Referenz

Diese Übersicht umfasst die gezeigten Attribute. Die Eingabelogik stammt aus flux:otp.

gedisa:otp

Eigenschaft
Werte
Default
size Größen sm, md, lg md
length Anzahl der Stellen 4
separator Trenner in der Mitte, automatisch bei sechs Stellen
label Beschriftung der Gruppe
description Hinweistext unter den Feldern
error Fehlermeldung, ersetzt den Hinweistext
invalid Markiert alle Felder als fehlerhaft
placeholder Placeholder pro Feld
input-label Zugänglicher Name pro Feld Stelle {current} von {total}
wire:model Bindung des gesamten Codes
disabled HTML-Attribut