Aller au contenu
1.6k

Saisie OTP

Champ de saisie d'un code à usage unique pour l'authentification à deux facteurs (2FA), la vérification de connexion et les écrans de code PIN — champs permettant le collage, avec des bordures de style néobrutaliste et des ombres marquées.

import {
  InputOTP,
  InputOTPGroup,

Le champ OTP est un champ de code à usage unique segmenté : des cases visuelles rendues par-dessus un unique champ natif, si bien que le collage et le remplissage automatique des codes sur mobile fonctionnent d’emblée. Les deux variantes de backend enveloppent la même bibliothèque input-otp de @guilherme_rodz — il n’y a aucune primitive Radix ou Base en dessous — avec des cases habillées selon la recette néobrutaliste : bordures épaisses, ombres franches et typographie affirmée.

À privilégier pour :

  • Authentification à deux facteurs — le code TOTP ou SMS à 6 chiffres après la connexion par mot de passe.
  • Vérification d’e-mail et de téléphone — confirmez la propriété du compte à l’inscription, au paiement ou lors de la récupération.
  • Saisie de code PIN — codes à 4 chiffres pour les écrans de verrouillage ou la confirmation de paiement (voir l’exemple Quatre chiffres).

À propos

Input OTP repose sur input-otp, signé @guilherme_rodz.

Installation

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

Installez les dépendances suivantes :

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

Copiez-collez le code suivant dans votre projet.

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 }

Adaptez les chemins d’import à la structure de votre projet.

Utilisation

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>

Composition

Utilisez la composition suivante pour construire un InputOTP :

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

Pattern

Utilisez la prop pattern pour définir un motif personnalisé pour le champ 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"

Exemples

Séparateur

Utilisez le composant <InputOTPSeparator /> pour ajouter un séparateur entre les groupes de champs.

import {
  InputOTP,
  InputOTPGroup,

Désactivé

Utilisez la prop disabled pour désactiver le champ.

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

Contrôlé

Utilisez les props value et onChange pour contrôler la valeur du champ.

"use client"

import * as React from "react"

Invalide

Utilisez aria-invalid sur les cases pour afficher un état d’erreur.

"use client"

import * as React from "react"

Quatre chiffres

Un motif courant pour les codes PIN. Il s’appuie sur la prop pattern={REGEXP_ONLY_DIGITS}.

"use client"

import { REGEXP_ONLY_DIGITS } from "input-otp"

Alphanumérique

Utilisez REGEXP_ONLY_DIGITS_AND_CHARS pour accepter à la fois les lettres et les chiffres.

"use client"

import { REGEXP_ONLY_DIGITS_AND_CHARS } from "input-otp"

Formulaire

import { RefreshCwIcon } from "lucide-react"

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

RTL

Pour activer le RTL dans Neobrutalism, consultez le guide de configuration RTL.

"use client"

import * as React from "react"

Accessibilité

Il n’existe pas de modèle WAI-ARIA APG pour les champs OTP, et il n’en faut pas : input-otp rend un seul vrai <input> avec autocomplete="one-time-code" derrière les cases visuelles ; les technologies d’assistance annoncent donc un unique champ de texte et les claviers mobiles peuvent suggérer le code entrant. Les cases sont présentationnelles — étiquetez le champ lui-même (un FormLabel ou un aria-label), et passez aria-invalid aux cases pour le style d’erreur.

Les interactions clavier suivent le comportement natif d’un champ de texte et sont identiques dans les variantes Radix et Base :

ToucheAction
Tab / Shift + TabEntre dans le champ / en sort (un seul arrêt de tabulation)
ArrowLeft / ArrowRightDéplace le curseur d’une case à l’autre
Home / EndSaute à la première / dernière case
Backspace / DeleteSupprime le caractère précédent / suivant
Ctrl/Cmd + VColle — le code remplit les cases s’il correspond à pattern

Référence API

Consultez la documentation input-otp pour en savoir plus.