# Input OTP

> Memasukkan kode sekali pakai di enam kotak.

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

## 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.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/input-otp/_

## Anatomi

1. Kotak terisi
2. Kotak yang aktif
3. Kotak 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

Hanya ada satu gaya, untuk enam angka.

## Props

| 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. |

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<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>
```

**Flutter**
```dart
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

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/input-otp.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input-otp.json
```

## Aksesibilitas

- 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.
