Vai al contenuto
1.6k

Input OTP

Campi per l'inserimento di codici monouso per l'autenticazione a due fattori (2FA), la verifica dell'accesso e le schermate del PIN — campi che supportano l'incollaggio, con bordi in stile neobrutalista e ombre marcate.

import {
  InputOTP,
  InputOTPGroup,

L’input OTP è un campo per codici monouso suddiviso in segmenti: slot visivi resi sopra un unico input nativo, così incollare e il riempimento automatico dei codici su mobile funzionano da subito. Entrambe le varianti di backend avvolgono la stessa libreria input-otp di @guilherme_rodz — non c’è nessuna primitiva Radix o Base sotto — con gli slot rifiniti secondo la ricetta neobrutalista: bordi spessi, ombre nette e tipografia in grassetto.

Quando usarlo:

  • Autenticazione a due fattori — il codice TOTP o SMS a 6 cifre dopo l’accesso con password.
  • Verifica di email e telefono — conferma la titolarità durante registrazione, checkout o recupero dell’account.
  • Inserimento di PIN — codici a 4 cifre per blocchi schermo o conferme di pagamento (vedi l’esempio Quattro cifre).

Informazioni

Input OTP è costruito su input-otp di @guilherme_rodz.

Installazione

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

Installa le seguenti dipendenze:

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

Copia e incolla il seguente codice nel tuo progetto.

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 }

Aggiorna i percorsi di importazione in base alla configurazione del tuo progetto.

Utilizzo

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>

Composizione

Usa la seguente composizione per costruire un InputOTP:

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

Pattern

Usa la prop pattern per definire un pattern personalizzato per l'input 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"

Esempi

Separatore

Usa il componente <InputOTPSeparator /> per aggiungere un separatore tra i gruppi di input.

import {
  InputOTP,
  InputOTPGroup,

Disabilitato

Usa la prop disabled per disabilitare l'input.

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

Controllato

Usa le prop value e onChange per controllare il valore dell'input.

"use client"

import * as React from "react"

Non valido

Usa aria-invalid sugli slot per mostrare uno stato di errore.

"use client"

import * as React from "react"

Quattro cifre

Un pattern comune per i codici PIN. Usa la prop pattern={REGEXP_ONLY_DIGITS}.

"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

Alfanumerico

Usa REGEXP_ONLY_DIGITS_AND_CHARS per accettare sia lettere che numeri.

"use client"

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"

Form

import { RefreshCwIcon } from "lucide-react"

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

RTL

Per abilitare il supporto RTL in Neobrutalism, consulta la guida alla configurazione RTL.

"use client"

import * as React from "react"

Accessibilità

Non esiste un pattern WAI-ARIA APG per i campi OTP, e non serve: input-otp rende un unico <input> reale con autocomplete="one-time-code" dietro gli slot visivi, così le tecnologie assistive annunciano un solo campo di testo e le tastiere mobili possono suggerire il codice in arrivo. Gli slot sono presentazionali — etichetta il campo stesso (una FormLabel o un aria-label) e passa aria-invalid agli slot per lo stile di errore.

Le interazioni da tastiera seguono il comportamento nativo dei campi di testo e sono identiche nelle varianti Radix e Base:

TastoAzione
Tab / Shift + TabSposta il focus dentro / fuori dal campo (un solo punto di tabulazione)
ArrowLeft / ArrowRightSposta il cursore tra gli slot
Home / EndSalta al primo / all’ultimo slot
Backspace / DeleteElimina il carattere precedente / successivo
Ctrl/Cmd + VIncolla — il codice riempie gli slot se corrisponde a pattern

Riferimento API

Consulta la documentazione di input-otp per maggiori informazioni.