Input kode sekali pakai yang dipecah menjadi kotak satu digit, dengan maju otomatis, dukungan tempel, dan satu input tersembunyi untuk submit form.
<x-markas.input-otp name="code" label="Verification code" />import { InputOTP } from "@/components/markas/InputOTP";
export default function InputOTPExample() {
return <InputOTP name="code" label="Verification code" />;
}<script setup lang="ts">
import { ref } from "vue";
import InputOTP from "@/components/markas/InputOTP.vue";
const code = ref("");
</script>
<template>
<InputOTP v-model="code" name="code" label="Verification code" />
</template><script lang="ts">
import InputOTP from "$lib/components/markas/InputOTP.svelte";
let code = $state("");
</script>
<InputOTP bind:value={code} name="code" label="Verification code" />---
import InputOTP from "@/components/markas/InputOTP.astro";
---
<InputOTP name="code" label="Verification code" />Contoh
Empat digit
<x-markas.input-otp name="pin" label="Card PIN" :length="4" />import { InputOTP } from "@/components/markas/InputOTP";
export default function Example() {
return <InputOTP name="pin" label="Card PIN" length={4} />;
}<script setup lang="ts">
import { ref } from "vue";
import InputOTP from "@/components/markas/InputOTP.vue";
const pin = ref("");
</script>
<template>
<InputOTP v-model="pin" name="pin" label="Card PIN" :length="4" />
</template><script lang="ts">
import InputOTP from "$lib/components/markas/InputOTP.svelte";
let pin = $state("");
</script>
<InputOTP bind:value={pin} name="pin" label="Card PIN" length={4} />---
import InputOTP from "@/components/markas/InputOTP.astro";
---
<InputOTP name="pin" label="Card PIN" length={4} />Status
<div class="grid gap-6">
<x-markas.input-otp name="filled_code" label="Filled" value="482913" />
<x-markas.input-otp name="locked_code" label="Disabled" value="12" disabled />
</div><script lang="ts">
import InputOTP from "$lib/components/markas/InputOTP.svelte";
let filled = $state("482913");
let locked = $state("12");
</script>
<div class="grid gap-6">
<InputOTP bind:value={filled} name="filled_code" label="Filled" />
<InputOTP bind:value={locked} name="locked_code" label="Disabled" disabled />
</div>---
import InputOTP from "@/components/markas/InputOTP.astro";
---
<div class="grid gap-6">
<InputOTP name="filled_code" label="Filled" value="482913" />
<InputOTP name="locked_code" label="Disabled" value="12" disabled />
</div>Kartu verifikasi
<form class="grid gap-5 rounded-lg border border-line bg-surface p-6">
<div class="grid gap-1">
<p class="text-base font-semibold text-ink">Check your email</p>
<p class="text-sm text-muted">We sent a 6-digit code to ana@example.com. It expires in 10 minutes.</p>
</div>
<x-markas.input-otp name="code" label="Verification code" />
<x-markas.button type="submit" class="w-full">Verify email</x-markas.button>
<p class="text-sm text-muted">Did not get a code? <a href="#" class="font-medium text-primary underline underline-offset-2">Send again</a></p>
</form>Instalasi
npx markasui@latest add input-otppnpm dlx markasui@latest add input-otpyarn dlx markasui@latest add input-otpbunx --bun markasui@latest add input-otp- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Pasang dependensi:
npm install alpinejs - Salin source komponen di bawah ini ke
resources/views/components/markas/input-otp.blade.php.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/InputOTP.tsx.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/InputOTP.vue.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/lib/components/markas/InputOTP.svelte.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/InputOTP.astro.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/app/markas/input-otp.component.ts.
Pemakaian
<x-markas.input-otp
name="code"
label="Kode verifikasi"
digit-label="Digit {index} dari {length}"
x-on:markas-complete="$el.closest('form').requestSubmit()"
/>Butuh Alpine.js. Setiap perubahan memancarkan markas-change dan kode yang lengkap memancarkan markas-complete, keduanya membawa kode di $event.detail. Isi kode awal lewat value.
Livewire
<x-markas.input-otp label="Code" wire:model.live="code" x-on:markas-complete="$wire.verify()" />wire:model terhubung ke kode gabungan sebagai satu string. Dengarkan markas-complete untuk verifikasi setelah semua kotak terisi.
import { useState } from "react";
import { InputOTP } from "@/components/markas/InputOTP";
const [code, setCode] = useState("");
<InputOTP
name="code"
label="Kode verifikasi"
digitLabel="Digit {index} dari {length}"
value={code}
onValueChange={setCode}
onComplete={(value) => verify(value)}
/>;<script setup lang="ts">
import { ref } from "vue";
import InputOTP from "@/components/markas/InputOTP.vue";
const code = ref("");
</script>
<template>
<InputOTP
v-model="code"
name="code"
label="Kode verifikasi"
digit-label="Digit {index} dari {length}"
@complete="(value) => verify(value)"
/>
</template><script lang="ts">
import InputOTP from "$lib/components/markas/InputOTP.svelte";
let kode = $state("");
</script>
<InputOTP
bind:value={kode}
name="code"
label="Kode verifikasi"
digitLabel="Digit {index} dari {length}"
oncomplete={(value) => verify(value)}
/>---
import InputOTP from "@/components/markas/InputOTP.astro";
---
<InputOTP
name="code"
label="Kode verifikasi"
digitLabel="Digit {index} dari {length}"
/>
<script>
document.addEventListener("markas-complete", (event) => {
verify((event as CustomEvent<string>).detail);
});
</script>Satu script kecil per halaman melayani semua kolom. Seperti Blade, fieldset memancarkan event markas-change dan markas-complete dengan kode di detail.
import { Component, signal } from "@angular/core";
import { InputOTP } from "./markas/input-otp.component";
@Component({
selector: "app-verifikasi",
imports: [InputOTP],
template: `
<markas-input-otp
[(value)]="kode"
name="code"
label="Kode verifikasi"
digitLabel="Digit {index} dari {length}"
(complete)="verify($event)"
/>
`,
})
export class Verifikasi {
readonly kode = signal("");
verify(kode: string) {
// Kirim kode ke API.
}
}- Kotak hanya menerima digit. Menempel kode lengkap mengisi semua kotak, walaupun ada spasi atau tanda hubung.
namedipasang di satu input tersembunyi berisi kode gabungan, jadi submit form biasa mengirimcode=123456.- Atribut tambahan dan
classjatuh ke<fieldset>.disabledmenonaktifkan semua kotak. - Label kotak bawaan berbahasa Inggris (“Digit {index} of {length}”). Terjemahkan lewat
digitLabel.
Props
| Nama | Tipe | Default | Keterangan |
|---|---|---|---|
length | number | 6 | Jumlah kotak digit. |
label | string | - | Label grup, dirender sebagai legend fieldset. |
name | string | - | Nama input tersembunyi yang berisi kode lengkap untuk submit form. |
value / defaultValue / v-model / bind:value | string | "" | Kode. React menerima value dengan onValueChange atau defaultValue; Vue memakai v-model; Svelte bind:value; Angular value atau [(value)]; Blade dan Astro memakai value. |
onValueChange / markas-change | (value: string) => void | - | Dipanggil setiap perubahan dengan kode gabungan (React). Blade dan Astro memancarkan event markas-change. |
onComplete / @complete / markas-complete | (value: string) => void | - | Dipanggil sekali saat semua kotak terisi, dengan kode lengkap. Blade dan Astro memancarkan event markas-complete. |
oncomplete | (value: string) => void | - | Khusus Svelte. Dipanggil sekali saat semua kotak terisi, dengan kode lengkap. |
complete | output<string> | - | Khusus Angular. Memancarkan kode lengkap saat semua kotak terisi. |
digitLabel | string | Digit {index} of {length} | aria-label tiap kotak. {index} dan {length} diganti angka. Isi misalnya "Digit {index} dari {length}". |
Aksesibilitas
- Kotak berada di fieldset dengan legend dari prop label, dan tiap kotak punya aria-label seperti "Digit 1 of 6".
- Mengetik digit memindah fokus ke kotak berikutnya; Backspace mengosongkan lalu mundur; panah kiri, panah kanan, Home, dan End berpindah kotak.
- Menempel kode mengisi semua kotak. Kotak pertama memakai autocomplete=one-time-code agar ponsel bisa menyarankan kode SMS.
- Kotak memakai inputmode=numeric untuk keyboard angka dan hanya menerima digit.
Komponen terkait
Komponen form lain dengan class yang sama di setiap framework.
- ButtonTombol dengan varian primary, secondary, ghost, dan danger.
- CheckboxKotak centang native dengan label dan deskripsi opsional, tampilan kustom tanpa JavaScript.
- ComboboxInput teks dengan daftar saran terfilter di popover, mengikuti pola WAI-ARIA Combobox dengan autocomplete list.
- InputKolom teks dengan label, petunjuk, dan pesan error yang terhubung lewat ARIA.
- LabelLabel form dengan gaya konsisten serta penanda wajib atau opsional yang dibacakan screen reader dengan benar.
- Radio GroupKelompok radio native dalam fieldset dan legend untuk memilih satu dari beberapa opsi.