Clase 06 · Módulo 05
Formularios, teclado y validación
Formularios, teclado y validación
Qué logras en esta clase
Construyes formularios que se llenan rápido con el pulgar y que explican bien cuando algo está mal.
- Configuras cada campo con el teclado que corresponde.
- Evitas que el teclado tape lo que se escribe.
- Decides qué validar, cuándo y dónde.
02
Escribir en un teléfono cuesta
En un computador el formulario es fácil: teclado grande, pantalla amplia. En un teléfono el teclado ocupa media pantalla, las teclas son pequeñas y el usuario suele estar de pie o apurado.
Cada campo que pides es fricción. Lo primero es preguntarse si ese dato es necesario ahora o puede pedirse después.
03
TextInput: el campo de texto
<TextInput
value={correo}
onChangeText={setCorreo}
placeholder="nombre@correo.com"
/>value es lo que el campo muestra y onChangeText avisa cada cambio. El texto vive en el estado del componente (módulo 4, clase 4): el campo solo lo refleja.
04
El principio de un buen formulario
Cada tecla que le ahorras al usuario aumenta las probabilidades de que termine el formulario.
05
El teclado correcto para cada campo
| Dato | keyboardType |
|---|---|
| Correo | email-address |
| Teléfono | phone-pad |
| Cantidad entera | number-pad |
| Monto con decimales | decimal-pad |
| Dirección web | url |
Elegir bien no impide que llegue otro contenido: el usuario puede pegar texto. El teclado ayuda; la validación decide.
06
Ayudas que casi nadie configura
autoCapitalize: desactívalo en correos y nombres de usuario.autoCorrect: desactívalo donde el corrector estorba (códigos, apellidos).autoComplete: le dice al sistema qué dato es, para ofrecer el correo o la dirección guardados.secureTextEntry: oculta lo escrito, para contraseñas.
07
Pasar de un campo al siguiente
La tecla de acción del teclado puede decir «siguiente», «listo» o «enviar» (prop returnKeyType), y onSubmitEditing define qué pasa al tocarla.
08
El problema clásico: el teclado tapa el campo
Al abrirse, el teclado cubre la mitad inferior de la pantalla. Si el campo activo o el botón de enviar quedan debajo, el usuario escribe a ciegas.
Cada sistema lo maneja distinto y no se arregla solo. Hay dos caminos, según el tamaño del formulario.
09
Dos formas de resolverlo
KeyboardAvoidingView | react-native-keyboard-controller | |
|---|---|---|
| Viene incluido | Sí | Se instala |
| Funciona en Expo Go | Sí | No: exige development build |
| Sirve para | Uno a tres campos | Formularios largos |
| Extra | — | Desplaza hasta el campo activo |
Ambas aparecen en la guía oficial de Expo sobre teclado.
10
KeyboardAvoidingView: lo simple
Envuelve la pantalla y la reacomoda cuando aparece el teclado. La guía de Expo indica que el valor padding de la prop behavior suele funcionar mejor.
Dos detalles documentados:
- Si la pantalla tiene encabezado de navegación, hay que descontar su altura con
keyboardVerticalOffset. - En Android, combinarlo con el modo de teclado
pandesplaza el campo dos veces.
11
keyboard-controller: formularios largos
Esta librería necesita además react-native-reanimated y que la app esté envuelta en su KeyboardProvider. Aporta dos piezas:
KeyboardAwareScrollView: se desplaza sola hasta el campo que recibe el foco.KeyboardToolbar: una barra sobre el teclado con anterior, siguiente y cerrar.
12
Cerrar el teclado
El usuario espera que el teclado se vaya al tocar fuera del campo o al desplazarse. No ocurre por defecto en todas las pantallas.
Keyboard.dismisslo cierra desde el código.- En pantallas con pestañas,
tabBarHideOnKeyboardoculta la barra inferior mientras el teclado está abierto.
13
Validar: para qué sirve cada lado
Validar en la app es comodidad para el usuario. Validar en el servidor es seguridad para los datos. Se hacen las dos.
14
Cuándo mostrar el error
| Momento | Ventaja | Riesgo |
|---|---|---|
| Mientras escribe | Respuesta inmediata | Reta al usuario antes de que termine |
| Al salir del campo | Oportuno y sin interrumpir | Requiere algo más de código |
| Al enviar | Simple | Varios errores juntos al final |
Lo habitual: validar al salir del campo y otra vez al enviar. Mientras escribe, solo para quitar un error que ya se corrigió.
15
Dónde ocurre cada validación
La app puede ser modificada o saltada: alguien puede enviar datos directo a tu servidor. Por eso las reglas que importan (formatos, rangos, permisos) se repiten en el servidor y en la base, como verás en los módulos 7 y 8.
16
Mensajes que ayudan
| No ayuda | Ayuda |
|---|---|
| «Campo inválido» | «Escribe un correo con @, como nombre@correo.com» |
| «Error» | «La contraseña necesita al menos 8 caracteres» |
| «Algo salió mal» | «No hay conexión. Tus datos siguen aquí; inténtalo de nuevo» |
Un buen mensaje dice qué pasó y qué hacer, junto al campo que falló y sin culpar al usuario.
17
Mientras se envía
- Deshabilita el botón apenas se toca.
- Muestra que algo está ocurriendo.
- Si falla, conserva lo escrito y explica el motivo.
- Si resulta, confirma y lleva al usuario al paso siguiente.
18
Estado propio o librería de formularios
| Opción | Conviene cuando |
|---|---|
Estado por campo (useState) | Formularios de pocos campos |
| Librería de formularios con esquema de validación | Muchos campos, reglas cruzadas, varios pasos |
Las más usadas en el ecosistema son React Hook Form para el formulario y Zod para describir las reglas. No las agregues por adelantado: pídelas cuando un formulario se vuelva difícil de leer.
19
Etiquetas y accesibilidad
El placeholder desaparece al escribir. Si es la única indicación, el usuario olvida qué pedía el campo y el lector de pantalla puede no anunciarlo.
- Pon una etiqueta visible y permanente sobre cada campo.
- Dale al campo un
accessibilityLabelcon ese mismo texto. - No marques el error solo con color rojo: agrega el mensaje.
20
Errores comunes
- Pedir datos que no se usan en la primera versión.
- Teclado de texto para un monto, o mayúscula automática en el correo.
- El botón de enviar tapado por el teclado.
- Validar solo en la app, o borrar el formulario cuando el envío falla.
- Probar el teclado en un solo sistema.
21
Lo que te llevas
- Menos campos y el teclado correcto en cada uno.
autoCompletey la tecla «siguiente» ahorran la mayor parte del esfuerzo.- Para pocos campos,
KeyboardAvoidingView; para formularios largos, keyboard-controller con development build. - La app valida por comodidad; el servidor, por seguridad.
- Un mensaje de error dice qué pasó y qué hacer.
22
Hazlo ahora
En 15 minutos:
- Pide a Claude Code un formulario de registro con nombre, correo, teléfono y contraseña.
- Llénalo en tu teléfono usando solo el pulgar.
- Anota cada momento incómodo: teclado equivocado, campo tapado, mayúsculas, saltos.
- Entrégale la lista a Claude y pide corregir uno por uno.
- Envía el formulario vacío y evalúa si los mensajes te dicen qué hacer.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026