Input OTP
Input OTP menerima kode sekali pakai, misalnya verifikasi email atau kode masuk, di enam kotak terpisah.
Kapan dipakai
Section titled “Kapan dipakai”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.
Kode verifikasi
Kami kirim kodenya ke email kamu.
Kode verifikasi
Kami kirim kodenya ke email kamu.
Anatomi
Section titled “Anatomi”- 1Kotak terisi
- 2Kotak yang aktif
- 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.
Varian
Section titled “Varian”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> )}<script setup lang="ts">import { useId } from "vue"import { REGEXP_ONLY_DIGITS } from "vue-input-otp"import { InputOTP, InputOTPGroup, InputOTPSlot } from "@/components/ui/input-otp"
const id = useId()</script>
<template> <div class="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`" class="text-sm font-medium">Kode verifikasi</p> <InputOTP :maxlength="6" :pattern="REGEXP_ONLY_DIGITS" autofocus :aria-labelledby="`${id}-label`" :aria-describedby="`${id}-hint`"> <InputOTPGroup> <InputOTPSlot v-for="index in 6" :key="index" :index="index - 1" /> </InputOTPGroup> </InputOTP> <p :id="`${id}-hint`" class="text-sm text-muted-foreground">Kami kirim kodenya ke email kamu.</p> </div></template>import 'package:flutter/services.dart';import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class InputOtpDemo extends StatelessWidget { const InputOtpDemo({super.key});
@override Widget build(BuildContext context) { final theme = ShadTheme.of(context); return Column( mainAxisSize: MainAxisSize.min, spacing: 8, children: [ Text('Kode verifikasi', style: theme.textTheme.small), // Six separate 48px boxes: one slot per group, 8px apart. ShadInputOTP( maxLength: 6, gap: 8, keyboardType: TextInputType.number, inputFormatters: [FilteringTextInputFormatter.digitsOnly], onChanged: (code) {}, children: [ for (var i = 0; i < 6; i++) const ShadInputOTPGroup(children: [ShadInputOTPSlot(width: 48, height: 48)]), ], ), Text('Kami kirim kodenya ke email kamu.', style: theme.textTheme.muted), ], ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/input-otp.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input-otp.jsonAksesibilitas
Section titled “Aksesibilitas”- Input sungguhan di balik kotak diberi nama oleh label lewat
aria-labelledbydan dihubungkan ke hint lewataria-describedby. - Input memakai
autocomplete="one-time-code", jadi HP bisa menawarkan kode dari pesan. - Backspace menghapus kotak sebelumnya; tombol panah berpindah antarkotak.
