콘텐츠로 건너뛰기
1.6k

OTP 입력

2단계 인증(2FA), 로그인 확인 및 PIN 입력 화면용 일회용 코드 입력란 — 네오브루탈리즘 스타일의 테두리와 강한 그림자가 적용된, 붙여넣기 기능을 지원하는 입력란.

import {
  InputOTP,
  InputOTPGroup,

Input OTP는 분할된 일회용 코드 필드입니다. 시각적 슬롯 아래에 네이티브 input 하나가 있어 붙여넣기와 모바일 코드 자동 완성이 그대로 동작합니다. 두 백엔드 변형 모두 @guilherme_rodz의 input-otp 라이브러리를 감싸며, 아래쪽에 Radix나 Base 프리미티브는 없습니다. 슬롯은 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.

다음과 같은 경우에 사용합니다.

  • 2단계 인증 — 비밀번호 로그인 뒤의 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

pattern prop 을 사용해 OTP 입력에 커스텀 패턴을 정의합니다.

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"

예제

구분자

<InputOTPSeparator /> 컴포넌트를 사용해 입력 그룹 사이에 구분자를 추가합니다.

import {
  InputOTP,
  InputOTPGroup,

비활성화

disabled prop 을 사용해 입력을 비활성화합니다.

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

제어된 입력

value 와 onChange prop 을 사용해 입력값을 제어합니다.

"use client"

import * as React from "react"

유효하지 않은 상태

슬롯에 aria-invalid 를 지정해 오류 상태를 표시합니다.

"use client"

import * as React from "react"

네 자리

PIN 코드에 흔히 쓰이는 패턴입니다. pattern={REGEXP_ONLY_DIGITS} prop 을 사용합니다.

"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

영숫자

REGEXP_ONLY_DIGITS_AND_CHARS 를 사용해 영문자와 숫자를 모두 받습니다.

"use client"

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"

폼

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는 시각 슬롯 뒤에 autocomplete="one-time-code"가 있는 실제 <input> 하나를 렌더링하므로, 보조 기술은 단일 텍스트 필드로 읽고 모바일 키보드는 수신 코드를 제안할 수 있습니다. 슬롯은 표현용입니다. 필드 자체에 레이블(FormLabel 또는 aria-label)을 달고, 오류 스타일링을 위해 슬롯에 aria-invalid를 전달하세요.

키보드 상호작용은 네이티브 텍스트 필드와 같고 Radix와 Base 변형에서 동일합니다.

키보드 상호작용:

키동작
Tab / Shift + Tab필드로 포커스 이동/이탈(탭 스톱 하나)
ArrowLeft / ArrowRight슬롯 사이 캐럿 이동
Home / End첫/마지막 슬롯으로 이동
Backspace / Delete이전/다음 문자 삭제
Ctrl/Cmd + V붙여넣기 — pattern과 맞으면 코드가 슬롯을 채움

API 참조

자세한 내용은 input-otp 문서를 참고하세요.