Input OTP
Códigos de un solo uso, una casilla por carácter. El autocompletado de SMS y pegar funcionan solos.
NuevoInstalación
Copia y pega el siguiente código en tu proyecto.
Actualiza las rutas de importación para que coincidan con la estructura de tu proyecto.
Anatomía
Composición
Usá la siguiente composición para construir un
InputOTP:Sin children renderiza
length casillas en un solo grupo. Pasá grupos y separadores cuando quieras partir el código, y dale a cada casilla su index.Debajo de las casillas hay un único
<input> real que guarda el código entero. Las casillas solo lo dibujan. Por eso el código de un SMS aparece como sugerencia del teclado en iOS y Android, pegar un código completo llena todas las casillas, y los gestores de contraseñas y lectores de pantalla lo tratan como cualquier campo de texto.Variantes
Por defecto (Default)
Alfanumérico (Alphanumeric)
Con
pattern="alphanumeric" también acepta letras y el teclado del celular pasa a texto. Si querés normalizar el valor, por ejemplo pasarlo a mayúsculas, controlalo.It is in the invite email from your workspace admin, like K7P-Q2X.
pattern también acepta una RegExp, que se prueba contra cada carácter: /^[A-F0-9]$/ acepta solo códigos hexadecimales.Teclado
| Tecla | Acción |
|---|---|
| Escribir | Llena la casilla activa y avanza. Ignora otros caracteres |
Backspace | Borra el carácter antes del cursor |
ArrowLeft, ArrowRight | Se mueve entre casillas |
Home, End | Salta a la primera casilla o a la primera vacía |
| Pegar | Llena las casillas desde el portapapeles, sin espacios ni guiones |
Hacer clic en una casilla mueve el cursor ahí, y lo que escribas reemplaza ese carácter.
Accesibilidad
- Nombralo como cualquier input: un
<label htmlFor>que apunte alid,aria-labeloaria-labelledby. Todo eso va al input real. - Las casillas están ocultas para las tecnologías de asistencia, así que los lectores de pantalla anuncian un solo campo de texto con su valor.
- El input tiene
autocomplete="one-time-code"einputmode="numeric"para dígitos. aria-invalidpone en rojo el borde de las casillas. Apuntáaria-describedbyal mensaje de error.
Referencia de API
InputOTP
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
length | number | 6 | Cantidad de caracteres del código |
value | string | - | Valor controlado |
defaultValue | string | '' | Valor inicial sin controlar |
onValueChange | (value: string) => void | - | Callback cuando cambia el valor |
onComplete | (value: string) => void | - | Callback cuando se llenan todas las casillas |
pattern | 'digits' | 'alphanumeric' | RegExp | 'digits' | Qué caracteres acepta |
disabled | boolean | false | Desactiva el input |
name | string | - | Envía el código con el formulario bajo este nombre |
required | boolean | - | Bloquea el envío hasta que el código esté completo |
autoFocus | boolean | false | Enfoca el input al montarse |
id | string | - | Id del input real, para <label htmlFor> |
aria-invalid | boolean | - | Marca el código como inválido |
className | string | - | Clases CSS adicionales del contenedor |
inputClassName | string | - | Clases CSS adicionales del input oculto |
ref | Ref<HTMLInputElement> | - | Ref al input real |
InputOTP.Slot
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
index | number | - | Posición del carácter que muestra |
className | string | - | Clases CSS adicionales |
Cada casilla lleva
data-active mientras el cursor está en ella y data-filled cuando tiene un carácter.InputOTP.Group, InputOTP.Separator
| Prop | Tipo | Por defecto | Descripción |
|---|---|---|---|
className | string | - | Clases CSS adicionales |
¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.