Pular para o conteúdo
1.6k

Entrada OTP

Campos para inserção de código único na autenticação de duas etapas (2FA), verificação de login e telas de PIN — campos que aceitam colagem, com bordas em estilo neobrutalista e sombras marcantes.

import {
  InputOTP,
  InputOTPGroup,

O input OTP é um campo segmentado para códigos de uso único: slots visuais renderizados sobre um único input nativo, então colar o código e o preenchimento automático no celular funcionam de imediato. As duas variantes de backend envolvem a mesma biblioteca input-otp, de @guilherme_rodz — não há primitivo do Radix nem do Base por baixo — com slots estilizados seguindo a receita neobrutalista: bordas grossas, sombras duras e tipografia em negrito.

Quando usar:

  • Autenticação em dois fatores — o código TOTP ou SMS de 6 dígitos depois do login com senha.
  • Verificação de e-mail e telefone — confirme a titularidade durante o cadastro, o checkout ou a recuperação de conta.
  • Entrada de PIN — códigos de 4 dígitos para bloqueio de tela ou confirmação de pagamento (veja o exemplo Quatro dígitos).

Sobre

O Input OTP é construído sobre o input-otp de @guilherme_rodz.

Instalação

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

Instale as seguintes dependências:

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

Copie e cole o código a seguir no seu projeto.

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 }

Atualize os caminhos de importação de acordo com a configuração do seu projeto.

Uso

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>

Composição

Use a seguinte composição para construir um InputOTP:

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

Pattern

Use a prop pattern para definir um padrão personalizado para o campo 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"

Exemplos

Separador

Use o componente <InputOTPSeparator /> para adicionar um separador entre grupos de campos.

import {
  InputOTP,
  InputOTPGroup,

Desabilitado

Use a prop disabled para desabilitar o campo.

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

Controlado

Use as props value e onChange para controlar o valor do campo.

"use client"

import * as React from "react"

Inválido

Use aria-invalid nos slots para mostrar um estado de erro.

"use client"

import * as React from "react"

Quatro dígitos

Um padrão comum para códigos PIN. Usa a prop pattern={REGEXP_ONLY_DIGITS}.

"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

Alfanumérico

Use REGEXP_ONLY_DIGITS_AND_CHARS para aceitar tanto letras quanto números.

"use client"

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"

Formulário

import { RefreshCwIcon } from "lucide-react"

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

RTL

Para ativar o suporte a RTL no Neobrutalism, consulte o guia de configuração de RTL.

"use client"

import * as React from "react"

Acessibilidade

Não existe um padrão WAI-ARIA APG para campos OTP, e nenhum é necessário: o input-otp renderiza um único <input> real com autocomplete="one-time-code" atrás dos slots visuais, então a tecnologia assistiva anuncia um único campo de texto e os teclados de celular podem sugerir o código recebido. Os slots são apresentacionais — rotule o campo em si (um FormLabel ou aria-label) e passe aria-invalid aos slots para o estilo de erro.

As interações de teclado seguem o comportamento nativo de campo de texto e são idênticas nas variantes Radix e Base:

TeclaAção
Tab / Shift + TabMove o foco para dentro / fora do campo (uma única parada de tabulação)
ArrowLeft / ArrowRightMove o cursor entre os slots
Home / EndVai para o primeiro / último slot
Backspace / DeleteApaga o caractere anterior / seguinte
Ctrl/Cmd + VCola — o código preenche os slots se corresponder ao pattern

Referência da API

Consulte a documentação do input-otp para obter mais informações.