Props de TextInput en React Native, con buscador
Referencia de props de TextInput en React Native
TextInput en React Native: referencia de props con buscador | We.Inc
Todas las props de TextInput que necesitas, en una tabla con buscador: textarea multiline, keyboardType, secureTextEntry, autoComplete, returnKeyType, submitBehavior y más.
TextInput es el componente base de React Native para escribir texto. Guarda su valor en el estado y actualízalo desde onChangeText, que te entrega la cadena nueva. Para un textarea, pon multiline a true y añade textAlignVertical: "top" para que Android se comporte como iOS. keyboardType, autoComplete y secureTextEntry eligen el teclado, la pista de autocompletado y el enmascarado de contraseñas.
Props de TextInput para los campos más habituales
- Campo
- Props
- Correo electrónico
- keyboardType="email-address" autoComplete="email" autoCapitalize="none"
- Contraseña
- secureTextEntry autoComplete="password" textContentType="password"
- Textarea
- multiline numberOfLines={4} textAlignVertical="top"
- Precio
- keyboardType="decimal-pad"
- Código de un solo uso
- keyboardType="number-pad" autoComplete="one-time-code" maxLength={6}
La referencia oficial es una larga lista alfabética. Esta página reúne las props que la gente busca, con sus valores reales y sus valores por defecto, en una tabla que puedes filtrar por nombre, valor o plataforma. Escribe multiline, password o android en el cuadro para acotarla.
- Escribe una palabra en el cuadro de filtro: el nombre de una prop, un valor como decimal-pad o una plataforma.
- Las filas que coinciden en cualquier columna siguen visibles; el contador bajo el cuadro te dice cuántas son.
- Lee la columna de valor por defecto antes de definir una prop; varios valores por defecto sorprenden.
- Copia los ejemplos bajo la tabla para un textarea, un campo de correo y una cadena de paso al campo siguiente.
- autoCapitalize vale sentences por defecto, así que ponlo a none en los campos de correo y de nombre de usuario.
- secureTextEntry no funciona junto con multiline; un campo de contraseña debe quedarse en una sola línea.
- inputMode tiene prioridad sobre keyboardType cuando defines los dos, así que elige uno.
- maxLength detiene la escritura en el límite, lo que evita el parpadeo de recortar la cadena tú mismo en onChangeText.
- Android dibuja un borde inferior por defecto; underlineColorAndroid="transparent" lo elimina.
Preguntas frecuentes
¿Cómo hago un textarea en React Native?
No existe un componente textarea aparte. Usa TextInput con multiline a true, dale una altura o numberOfLines y añade textAlignVertical: "top" para que la primera línea empiece arriba en Android, igual que en iOS.
¿Por qué la tecla Return añade una línea nueva en vez de enviar?
En un campo multilínea, submitBehavior vale "newline" por defecto. Ponlo a "submit" o "blurAndSubmit" si Return debe disparar onSubmitEditing. Los campos de una línea usan "blurAndSubmit" por defecto.
¿Qué sustituyó a blurOnSubmit?
submitBehavior. La documentación marca blurOnSubmit como obsoleto, y submitBehavior lo anula cuando están los dos.
¿Qué valores de keyboardType funcionan en ambas plataformas?
default, number-pad, decimal-pad, numeric, email-address, phone-pad y url. Otros, como twitter y web-search en iOS o visible-password en Android, solo se aplican a una plataforma.
Controlado o no controlado
- La mayoría de las pantallas pasan value y onChangeText, de modo que el estado siempre contiene lo que se ve en pantalla y puedes validarlo o darle formato. defaultValue da una cadena inicial sin seguir cada pulsación, lo que encaja con un campo que solo lees una vez, al enviar.
- Recurre a una ref cuando necesites mover el foco. Llamar a focus() sobre la ref del campo siguiente dentro de onSubmitEditing te da el comportamiento habitual de pulsar Return para bajar por el formulario.
Teclados y autocompletado
- keyboardType cambia las teclas que ve la persona; nunca valida lo que escribe. Un campo decimal-pad puede recibir letras pegadas, así que comprueba la cadena antes de guardarla.
- autoComplete es la pista multiplataforma para el autocompletado del sistema, y textContentType es la exclusiva de iOS. Definir ambas en los campos de inicio de sesión permite que las contraseñas guardadas y los códigos de un solo uso de los mensajes se rellenen en cualquiera de las dos plataformas.
Ejemplos de TextInput
Un textarea multilínea
textAlignVertical mantiene el cursor arriba en Android, y el contador de caracteres lee directamente del estado.
Campo de correo que pasa el foco al campo siguiente
returnKeyType="next" pone la etiqueta a la tecla, y onSubmitEditing enfoca el campo de contraseña a través de su ref.
Props de TextInput, valores y valores por defecto
- Prop
- Valores o tipo
- Por defecto
- Plataforma
- Qué hace
- value / onChangeText
- string / (text) => void
- Ambas
- Texto controlado y el callback que recibe cada cadena nueva
- defaultValue
- Ambas
- Texto inicial cuando no controlas el valor
- Ambas
- Pista que se muestra mientras el campo está vacío
- placeholderTextColor
- Ambas
- Color del texto del placeholder
- Ambas
- Permite varias líneas; el textarea de React Native
- numberOfLines
- Ambas
- Máximo de líneas visibles; en iOS solo con la New Architecture
- keyboardType
- default, number-pad, decimal-pad, numeric, email-address, phone-pad, url
- Ambas
- Qué teclado se abre
- keyboardType (iOS)
- ascii-capable, numbers-and-punctuation, name-phone-pad, twitter, web-search
- iOS
- Teclados extra que solo ofrece iOS
- keyboardType (Android)
- Android
- Un teclado sin sugerencias
- inputMode
- none, text, decimal, numeric, tel, search, email, url
- Ambas
- Como el atributo HTML inputmode; tiene prioridad sobre keyboardType
- secureTextEntry
- Ambas
- Enmascara el texto; no funciona con multiline
- autoComplete
- email, password, username, new-password, one-time-code, off y más
- Ambas
- Pista de autocompletado para el sistema; off lo desactiva
- textContentType
- password, newPassword, oneTimeCode, emailAddress, username, none y más
- iOS
- Indica a iOS qué contiene el campo para el llavero y el autocompletado de códigos
- passwordRules
- iOS
- Requisitos para las contraseñas generadas cuando textContentType es newPassword
- autoCapitalize
- characters, words, sentences, none
- Ambas
- Qué letras pasan a mayúscula automáticamente
- autoCorrect
- Ambas
- Activa o desactiva la autocorrección
- maxLength
- Ambas
- Detiene la entrada en este número de caracteres
- Ambas
- false hace el campo de solo lectura
- readOnly
- Ambas
- true hace el campo de solo lectura; una alternativa a editable
- returnKeyType
- done, go, next, search, send
- Ambas
- Etiqueta de la tecla Return; hay más valores según la plataforma
- onSubmitEditing
- ({nativeEvent}) => void
- Ambas
- Se ejecuta al pulsar la tecla de envío; no se invoca con phone-pad en iOS
- submitBehavior
- submit, blurAndSubmit, newline
- blurAndSubmit (una línea), newline (multilínea)
- Ambas
- Qué hace Return; sustituye a blurOnSubmit
- blurOnSubmit
- Ambas
- Obsoleto en favor de submitBehavior
- underlineColorAndroid
- Android
- Color del borde inferior por defecto; transparent lo oculta
Filtra las props
Filtra por prop, valor o plataforma
{n} de {v} props visibles
Ninguna prop coincide con ese filtro.
Crea tu sitio gratis · Gratis para crear, sin tarjeta
Relacionado: Guías
- React memo, useMemo y useCallback
- Ejemplos de React Router (v7)
- React Server Components explicados
- Ejemplos de tablas de datos en React con TanStack Table
- React con TypeScript
- Librerías de UI para React
- React vs React Native
- Chuleta de regex
Producto
Para quién es
- Para agencias
- Para freelancers
- Para proveedores de hosting
- Para plataformas SaaS
- Para startups
- Servicios financieros
- Soluciones para salud
Funciones
Recursos
- Blog
- Centro de Ayuda
- Herramientas gratuitas para empresas
- Free UI Components
- Plantillas
- Colecciones de plantillas
- Ejemplos de webs
- Guías
- Comparativas
- Alternativas
- Los mejores
- Reseñas
- Guías de precios
- Casos de uso
- Glosario y guías
- Integraciones
- Desarrolladores
- Benchmark
- Windows App