Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Input OTP

    Input kode sekali pakai yang dipecah menjadi kotak satu digit, dengan maju otomatis, dukungan tempel, dan satu input tersembunyi untuk submit form.

    Verification code
    Verification code
    Verification code
    Verification code
    Verification code
    <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" />
    import { Component, signal } from "@angular/core";
    import { InputOTP } from "./markas/input-otp.component";
    
    @Component({
      selector: "markas-example",
      imports: [InputOTP],
      template: `
        <markas-input-otp [(value)]="code" name="code" label="Verification code" />
      `,
    })
    export default class InputOTPExample {
      readonly code = signal("");
    }

    Contoh

    Empat digit

    Card PIN
    Card PIN
    Card PIN
    Card PIN
    Card PIN

    Status

    Filled
    Disabled
    Filled
    Disabled
    Filled
    Disabled
    Filled
    Disabled
    Filled
    Disabled

    Kartu verifikasi

    Check your email

    We sent a 6-digit code to ana@example.com. It expires in 10 minutes.

    Verification code

    Did not get a code? Send again

    Check your email

    We sent a 6-digit code to ana@example.com. It expires in 10 minutes.

    Verification code

    Did not get a code? Send again

    Check your email

    We sent a 6-digit code to ana@example.com. It expires in 10 minutes.

    Verification code

    Did not get a code? Send again

    Check your email

    We sent a 6-digit code to ana@example.com. It expires in 10 minutes.

    Verification code

    Did not get a code? Send again

    Check your email

    We sent a 6-digit code to ana@example.com. It expires in 10 minutes.

    Verification code

    Did not get a code? Send again

    Instalasi

    npx markasui@latest add input-otp

    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.
    • name dipasang di satu input tersembunyi berisi kode gabungan, jadi submit form biasa mengirim code=123456.
    • Atribut tambahan dan class jatuh ke <fieldset>. disabled menonaktifkan semua kotak.
    • Label kotak bawaan berbahasa Inggris (“Digit {index} of {length}”). Terjemahkan lewat digitLabel.

    Props

    NamaTipeDefaultKeterangan
    lengthnumber6Jumlah kotak digit.
    labelstring-Label grup, dirender sebagai legend fieldset.
    namestring-Nama input tersembunyi yang berisi kode lengkap untuk submit form.
    value / defaultValue / v-model / bind:valuestring""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.
    completeoutput<string>-Khusus Angular. Memancarkan kode lengkap saat semua kotak terisi.
    digitLabelstringDigit {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.