OTP input
Campo para códigos de un solo uso, con una casilla por carácter.
- Navegadores
- Chrome 123+Firefox 121+Safari 17.5+
- Nivel
- 2
- Tamaño comprimido
- 1.53 kB
- Presupuesto de diseño forzado
- 0 ms
- Presupuesto de axe
- 0
- Compatible con SSR
- Sí
- Contrato publicado
- Entorno de pruebas
Zona de pruebas
OTP Input
Default
API
OtpInput.Root
| Prop | Tipo | Predeterminado | Descripción |
|---|---|---|---|
value | string | — | Código actual; hace que el campo sea controlado. |
defaultValue | string | "" | Código inicial del campo no controlado. |
onValueChange | (value: string) => void | — | Se llama con el código cada vez que cambia. |
onComplete | (value: string) => void | — | Se llama cuando el código alcanza la longitud configurada. |
length | number | 6 | Número de caracteres del código. |
type | "numeric" | "alphanumeric" | "numeric" | Caracteres que se conservan al escribir o pegar. |
mask | boolean | false | Oculta los caracteres introducidos en las casillas. |
disabled | boolean | false | Desactiva el input oculto y establece el atributo data-disabled. |
autoFocus | boolean | false | Da el foco al input oculto cuando se monta el campo. |
id | string | — | Id aplicado al elemento raíz renderizado. |
render | ReactElement | ((props, state) => ReactElement) | — | Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad. |
OtpInput.Slot
| Prop | Tipo | Predeterminado | Descripción |
|---|---|---|---|
index* | number | — | Posición del código que muestra esta casilla. |
render | ReactElement | ((props, state) => ReactElement) | — | Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad. |
OtpInput.HiddenInput
| Prop | Tipo | Predeterminado | Descripción |
|---|---|---|---|
autoFocus | boolean | — | Da el foco a este input al montarlo, reemplazando la configuración de la raíz. |
render | ReactElement | ((props, state) => ReactElement) | — | Reemplaza el elemento renderizado y conserva las conexiones de comportamiento y accesibilidad. |
Teclado
| Tecla | Acción |
|---|---|
| Tab | Llevar el foco al control o sacarlo de él |
| Enter / Space | Activar cuando tiene el foco (controles de tipo botón) |
Accesibilidad
Usa HTML semántico siempre que es posible. Inspecciona el marcado renderizado en el entorno de pruebas: ARIA se añade solo cuando los elementos nativos no bastan.
Puntos de estilo
data-disabled