Lewati ke konten

Input OTP

Unduh .md

Input OTP menerima kode sekali pakai, misalnya verifikasi email atau kode masuk, di enam kotak terpisah.

Pakai untuk setiap kode sekali pakai di semua produk Sosialoka, dengan aturan ini:

  • Enam kotak terpisah, tidak pernah satu kolom teks.
  • Hanya angka. Menempel kode utuh dari email langsung mengisi semua kotak.
  • Kirim saat lengkap. Begitu angka keenam masuk, kirim kodenya tanpa perlu diklik. Tombol kirim tetap ada, nonaktif sampai kode lengkap, dan fungsi kirimnya dijaga supaya hanya jalan sekali.
  • Kosongkan saat backend menolak kodenya, supaya kursor kembali ke kotak pertama; tampilkan pesan dari backend di bawahnya.
  • Fokuskan kotak pertama saat layar atau langkahnya muncul.
  • Taruh label di atas kotak sebagai elemen p, rata tengah bersama hint-nya.
React

Kode verifikasi

Kami kirim kodenya ke email kamu.

Vue

Kode verifikasi

Kami kirim kodenya ke email kamu.

123
  1. 1Kotak terisi
  2. 2Kotak yang aktif
  3. 3Kotak kosong

Enam kotak 48px (size-12) dengan radius-md dan border input, berjarak 8px, teks text-lg. Kotak aktif menampilkan ring; kode yang ditolak membuat semua border destructive. Satu input sungguhan ada di balik kotak-kotak itu, dan itulah yang membuat mengetik, menghapus, dan menempel bisa jalan.

Hanya ada satu gaya, untuk enam angka.

React Vue Flutter Tipe Default Kegunaan
maxLength maxlength maxLength angka tidak ada Jumlah angka: 6.
pattern={REGEXP_ONLY_DIGITS} :pattern="REGEXP_ONLY_DIGITS" FilteringTextInputFormatter.digitsOnly pola semua karakter Hanya menerima angka.
value / onChange v-model onChanged teks "" Kode yang sudah diketik.
onComplete @complete cek panjangnya di onChanged function tidak ada Jalan saat kotak terakhir terisi: kirim di sini.
aria-invalid aria-invalid error di bawahnya boolean false Menandai kode yang ditolak.
import { useId } from "react"
import { REGEXP_ONLY_DIGITS } from "input-otp"
import { InputOTP, InputOTPGroup, InputOTPSlot } from "@/components/ui/input-otp"
export default function InputOtpDemo() {
const id = useId()
return (
<div className="grid justify-items-center gap-2 text-center">
{/* One real input sits behind the six boxes, so the label points at it through aria-labelledby. */}
<p id={`${id}-label`} className="text-sm font-medium">Kode verifikasi</p>
<InputOTP maxLength={6} pattern={REGEXP_ONLY_DIGITS} autoFocus aria-labelledby={`${id}-label`} aria-describedby={`${id}-hint`}>
<InputOTPGroup>
{[0, 1, 2, 3, 4, 5].map((index) => (
<InputOTPSlot key={index} index={index} />
))}
</InputOTPGroup>
</InputOTP>
<p id={`${id}-hint`} className="text-sm text-muted-foreground">Kami kirim kodenya ke email kamu.</p>
</div>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/input-otp.json
  • Input sungguhan di balik kotak diberi nama oleh label lewat aria-labelledby dan dihubungkan ke hint lewat aria-describedby.
  • Input memakai autocomplete="one-time-code", jadi HP bisa menawarkan kode dari pesan.
  • Backspace menghapus kotak sebelumnya; tombol panah berpindah antarkotak.