Cuando un formulario de registro pide confirmar el email, solemos pensar primero en la API: enviar el mensaje, esperar el código y comprobarlo. En la interfaz, sin embargo, hay una pequeña máquina de estados que decide si la experiencia se siente clara o rota.
En mis formularios React intento tratar esa máquina como una parte del diseño, no como un detalle que se arregla al final. Un botón que cambia de texto, un error que empuja todo el layout o un foco que desaparece pueden hacer que una tarea sencilla se vuelva confusa. Esto suena pequeño, aunque cambia bastante cuando la persona navega con teclado o usa un lector de pantalla.
El problema: el email también tiene estados de interfaz
Un flujo de verificación suele tener, como mínimo, estos estados:
-
idle: el formulario está listo para recibir la dirección. -
sending: la solicitud está en curso y no conviene duplicarla. -
sent: el código fue enviado y aparece un campo para introducirlo. -
verifying: se está comprobando el código. -
success: la dirección quedó confirmada. -
error: hay que explicar qué puede hacer la persona ahora.
Cuando estos estados se mezclan en varios booleanos (isLoading, hasSent, isValid), aparecen combinaciones imposibles. Por ejemplo, un mensaje puede decir “enviado” mientras el botón sigue bloqueado por un error anterior. Es facil que el código funcione en el caso feliz y se comporte raro al repetir el envío.
Un status único hace más visible la intención:
type EmailStatus = | "idle" | "sending" | "sent" | "verifying" | "success" | "error"; const [status, setStatus] = useState<EmailStatus>("idle"); Así, cada transición se puede revisar junto con su texto, su foco y su comportamiento visual. También ayuda a que el equipo de QA reproduzca el flujo sin adivinar qué combinación de flags provocó el fallo.
Si el flujo tiene más pasos, me ha resultado útil separar la lógica de red de la presentación y documentar los estados claros para un inbox temporal. La idea es la misma: una pantalla debe tener un estado que se pueda nombrar.
Accesibilidad y rendimiento en cada transición
El feedback no debe depender solo del color. Un mensaje de error puede usar role="alert" cuando necesita anunciarse de inmediato, mientras que una confirmación menos urgente puede vivir en un aria-live="polite". No pondría role="alert" en todo: si cada cambio interrumpe la lectura, la experiencia se vuelve cansada.
El foco también necesita una regla. Tras enviar correctamente, el foco puede ir al encabezado que explica cómo introducir el código. Si la solicitud falla, debe quedarse cerca del campo que se puede corregir. Sin esta decisión, el teclado queda perdido y toca volver a buscar donde estaba el problema.
Para el CSS, reserva espacio para los mensajes desde el principio. Un contenedor con min-height o una fila de ayuda estable evita que el formulario salte cuando llega la respuesta. Este enfoque complementa bien estas técnicas para mostrar errores de email sin CLS. El rendimiento percibido mejora aunque la red tarde lo mismo.
Un patrón sencillo para el botón puede ser:
<button type="submit" disabled={status === "sending"}> {status === "sending" ? "Enviando…" : "Enviar código"} </button> El texto debe explicar la acción actual, no solo mostrar un spinner. Un lector de pantalla necesita saber si la solicitud sigue en curso; una animación sola no cuenta toda la historia.
Cómo probar el flujo con un correo desechable
Para pruebas manuales y de staging, uso una dirección aislada que no mezcle mensajes reales con datos de QA. Un correo desechable permite revisar el mensaje, abrir el enlace y comprobar que la aplicación actualiza el estado correcto sin tocar una bandeja personal.
En una revisión de frontend compruebo también los casos menos comodos:
- Enviar dos veces con rapidez: el segundo clic no debe crear una carrera.
- Recargar después de recibir el código: la interfaz debe explicar qué se perdió.
- Introducir un código caducado: el error debe indicar el siguiente paso.
- Volver atrás y cambiar el email: el código anterior no debe validarse para la nueva dirección.
- Usar teclado y zoom alto: ningún mensaje debe quedar oculto ni cortar el botón.
En las notas de prueba suelen aparecer búsquedas extrañas como temp org mail o tamp mail com. Las trato como texto de QA, no como nombres de campos ni como enlaces: si el requisito está mal escrito, la interfaz aún puede seguir siendo clara.
Checklist final
- ¿Existe un estado explícito para cada respuesta de red?
- ¿El foco tiene un destino definido después de éxito y error?
- ¿Los mensajes se anuncian sin repetir información innecesaria?
- ¿El espacio de ayuda evita cambios bruscos de layout?
- ¿El botón impide duplicar solicitudes mientras se envía?
- ¿Se puede probar la dirección
burner email addresssin usar datos personales? - ¿La copia sigue siendo comprensible incluso cuando la red va lenta?
Una interfaz de verificación no necesita muchos componentes para ser sólida. Necesita estados con nombres claros, transiciones previsibles y una salida accesible para cada fallo. Cuando React, CSS y Accessibility se revisan juntos, el formulario se siente más tranquilo: la persona sabe qué pasó y cuál es el siguiente paso.


