सामग्री पर जाएँ

OTP इनपुट

2FA, साइन-इन सत्यापन और PIN स्क्रीन के लिए एक-बार कोड प्रविष्टि — नियोब्रुटलिस्ट शैली की सीमाओं और कठोर छायाओं के साथ पेस्ट-जागरूक स्लॉट्स।

import {
  InputOTP,
  InputOTPGroup,

इनपुट OTP एक खंडित one-time-code फ़ील्ड है: विज़ुअल स्लॉट एक नेटिव इनपुट पर रेंडर होते हैं, ताकि paste और मोबाइल कोड autofill तुरंत काम करें। दोनों बैकएंड एक ही input-otp लाइब्रेरी (@guilherme_rodz) को रैप करते हैं — नीचे कोई Radix या Base प्रिमिटिव नहीं — स्लॉट नियोब्रूटलिस्ट रेसिपी के अनुसार स्टाइल किया गया है: मोटे बॉर्डर, कठोर छायाएँ और बोल्ड टाइपोग्राफ़ी।

इसे इन स्थितियों में चुनें:

  • Two-factor auth — पासवर्ड साइन-इन के बाद 6-अंकों का TOTP या SMS कोड।
  • ईमेल और फ़ोन वेरिफ़िकेशन — साइनअप, चेकआउट या अकाउंट रिकवरी में स्वामित्व पुष्टि।
  • PIN प्रविष्टि — स्क्रीन लॉक या पेमेंट पुष्टि के लिए 4-अंक (Four Digits उदाहरण देखें)।

परिचय

Input OTP, @guilherme_rodz द्वारा बनाए गए input-otp के ऊपर बनाया गया है.

इंस्टॉलेशन

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/input-otp.json
npx shadcn@latest add https://neobrutalism.com/r/base/input-otp.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/input-otp.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/input-otp.json

निम्नलिखित डिपेंडेंसी इंस्टॉल करें:

pnpm add input-otp
npm install input-otp
yarn add input-otp
bun add input-otp

निम्नलिखित कोड को अपने प्रोजेक्ट में कॉपी और पेस्ट करें.

components/ui/input-otp.tsx
"use client"

import * as React from "react"
import { OTPInput, OTPInputContext } from "input-otp"
import { MinusIcon } from "lucide-react"

import { cn } from "@/lib/utils"

function InputOTP({
  className,
  containerClassName,
  ...props
}: React.ComponentProps<typeof OTPInput> & {
  containerClassName?: string
}) {
  return (
    <OTPInput
      data-slot="input-otp"
      containerClassName={cn(
        "cn-input-otp flex items-center has-disabled:opacity-50",
        containerClassName
      )}
      spellCheck={false}
      className={cn("disabled:cursor-not-allowed", className)}
      {...props}
    />
  )
}

function InputOTPGroup({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="input-otp-group"
      className={cn(
        "flex items-center rounded has-aria-invalid:border-destructive",
        className
      )}
      {...props}
    />
  )
}

function InputOTPSlot({
  index,
  className,
  ...props
}: React.ComponentProps<"div"> & {
  index: number
}) {
  const inputOTPContext = React.useContext(OTPInputContext)
  const { char, hasFakeCaret, isActive } = inputOTPContext?.slots[index] ?? {}

  return (
    <div
      data-slot="input-otp-slot"
      data-active={isActive}
      className={cn(
        "relative flex size-8 items-center justify-center border-y-2 border-r-2 bg-input text-sm shadow-sm transition-all outline-none first:rounded-l first:border-l-2 last:rounded-r aria-invalid:border-destructive data-[active=true]:z-10 data-[active=true]:outline-2 data-[active=true]:outline-primary data-[active=true]:aria-invalid:border-destructive",
        className
      )}
      {...props}
    >
      {char}
      {hasFakeCaret && (
        <div className="pointer-events-none absolute inset-0 flex items-center justify-center">
          <div className="h-4 w-px animate-caret-blink bg-foreground duration-1000" />
        </div>
      )}
    </div>
  )
}

function InputOTPSeparator({ ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="input-otp-separator"
      className="flex items-center [&_svg:not([class*='size-'])]:size-4"
      role="separator"
      {...props}
    >
      <MinusIcon />
    </div>
  )
}

export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator }

अपने प्रोजेक्ट सेटअप के अनुसार इंपोर्ट पाथ अपडेट करें.

उपयोग

import {
  InputOTP,
  InputOTPGroup,
  InputOTPSeparator,
  InputOTPSlot,
} from "@/components/ui/input-otp"
<InputOTP maxLength={6}>
  <InputOTPGroup>
    <InputOTPSlot index={0} />
    <InputOTPSlot index={1} />
    <InputOTPSlot index={2} />
  </InputOTPGroup>
  <InputOTPSeparator />
  <InputOTPGroup>
    <InputOTPSlot index={3} />
    <InputOTPSlot index={4} />
    <InputOTPSlot index={5} />
  </InputOTPGroup>
</InputOTP>

कंपोज़िशन

InputOTP बनाने के लिए निम्नलिखित कंपोज़िशन का उपयोग करें:

InputOTP
├── InputOTPGroup
│   ├── InputOTPSlot
│   ├── InputOTPSlot
│   └── InputOTPSlot
├── InputOTPSeparator
├── InputOTPGroup
│   ├── InputOTPSlot
│   ├── InputOTPSlot
│   └── InputOTPSlot
├── InputOTPSeparator
└── InputOTPGroup
    ├── InputOTPSlot
    └── InputOTPSlot

Pattern

OTP इनपुट के लिए कस्टम पैटर्न परिभाषित करने के लिए pattern प्रॉप का उपयोग करें.

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"
 
;<InputOTP maxLength={6} pattern={REGEXP_ONLY_DIGITS_AND_CHARS}>
  ...
</InputOTP>
"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

उदाहरण

Separator

इनपुट समूहों के बीच सेपरेटर जोड़ने के लिए <InputOTPSeparator /> कंपोनेंट का उपयोग करें.

import {
  InputOTP,
  InputOTPGroup,

अक्षम

इनपुट को अक्षम करने के लिए disabled प्रॉप का उपयोग करें.

import { Field, FieldLabel } from "@/components/ui/field"
import {
  InputOTP,

Controlled

इनपुट वैल्यू को नियंत्रित करने के लिए value और onChange प्रॉप्स का उपयोग करें.

"use client"

import * as React from "react"

अमान्य

एरर स्टेट दिखाने के लिए स्लॉट्स पर aria-invalid का उपयोग करें.

"use client"

import * as React from "react"

Four Digits

PIN कोड के लिए एक सामान्य पैटर्न. यह pattern={REGEXP_ONLY_DIGITS} प्रॉप का उपयोग करता है.

"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

Alphanumeric

अक्षर और संख्या दोनों स्वीकार करने के लिए REGEXP_ONLY_DIGITS_AND_CHARS का उपयोग करें.

"use client"

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"

Form

import { RefreshCwIcon } from "lucide-react"

import { Button } from "@/components/ui/button"

RTL

Neobrutalism में RTL सपोर्ट सक्षम करने के लिए, RTL कॉन्फ़िगरेशन गाइड देखें.

"use client"

import * as React from "react"

एक्सेसिबिलिटी

OTP फ़ील्ड के लिए कोई WAI-ARIA APG पैटर्न नहीं है, और ज़रूरत भी नहीं: input-otp विज़ुअल स्लॉट के पीछे एक असली <input> autocomplete="one-time-code" के साथ रेंडर करता है, इसलिए असिस्टिव टेक एक टेक्स्ट फ़ील्ड घोषित करते हैं और मोबाइल कीबोर्ड आने वाला कोड सुझा सकते हैं। स्लॉट प्रेजेंटेशनल हैं — फ़ील्ड को खुद लेबल करें (FormLabel या aria-label), और एरर स्टाइल के लिए स्लॉट पर aria-invalid पास करें।

कीबोर्ड इंटरैक्शन नेटिव टेक्स्ट-फ़ील्ड व्यवहार का पालन करते हैं और Radix तथा Base वैरिएंट में एक जैसे हैं:

कीबोर्ड इंटरैक्शन:

कुंजीक्रिया
Tab / Shift + Tabफ़ील्ड में / से फ़ोकस ले जाएँ (एक टैब स्टॉप)
ArrowLeft / ArrowRightस्लॉटों के बीच कैरेट ले जाएँ
Home / Endपहले / आख़िरी स्लॉट पर जाएँ
Backspace / Deleteपिछला / अगला वर्ण हटाएँ
Ctrl/Cmd + Vपेस्ट — pattern से मिलने पर कोड स्लॉट भरता है

API रेफ़रेंस

अधिक जानकारी के लिए input-otp डॉक्युमेंटेशन देखें.