Guías prácticas

Escribir errores de formulario que ayuden a las personas a recuperar

Un error ayuda solo cuando alguien sabe lo que falló y puede reanudarse sin volver a ingresar todo.

Ver el método

Ilustración — Escribir errores de formulario que ayuden a las personas a recuperar
Ilustración generada por IA

Describa la corrección esperada

Conecte cada mensaje a su campo y explique la información requerida. “La dirección de correo electrónico está incompleta” ayuda más que un código técnico. No culpe al usuario por una interrupción del servidor o un servicio no disponible.

Explique las reglas antes de la entrada cuando sea posible: formato, longitud, archivos aceptados e información opcional. Los Guía de formularios de contacto Ayuda a reducir los campos y aclarar las expectativas.

El momento de validación forma parte del mensaje. Un campo obligatorio vacío al abrir no debe anunciarse como erróneo antes de intentar enviar. Al escribir una dirección, un valor provisional como alex@ no exige necesariamente una alerta por cada tecla. Según la tarea, valide al salir del campo o después del envío; el retorno inmediato puede ser útil para consultar disponibilidad a distancia.

aria-invalid indica que una validación ha rechazado el valor; no define las reglas ni bloquea por sí mismo el envío. Asocie el estado con un mensaje de corrección y reevalúelo después. Un formato de correo aceptado no demuestra que la dirección sea alcanzable. La comprobación pendiente y el fallo del servicio necesitan mensajes propios.

  • Campo y problema identificable.
  • acción de corrección explícita.
  • Restricciones explicadas temprano.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Ejercicio ficticio: elegir cuándo anunciar un error
Momento observadoRespuesta adecuada al casoControl que realizar
Primera apertura, campo obligatorio vacíoEtiqueta, indicación de obligatoriedad y ayudaSin aria-invalid="true" prematuro
Dirección todavía en escrituraDejar terminar según la estrategia elegidaEvitar alertas repetidas por un estado provisional
Intento de envío con valor rechazadoError explícito asociado al campoaria-invalid, mensaje accesible y corrección posible

hacer que la retroalimentación sea perceptible

Después del envío, muestre un resumen cerca del principio y un mensaje al lado de cada campo afectado. Mueva el enfoque de manera predecible y conecte cada campo a su error de tecnología de asistencia. El color por sí solo es insuficiente.

Los Tutorial de notificación W3C Da ejemplos de retroalimentación local y general. Prueba de teclado, lector de pantalla, zoom y pantallas estrechas.

Ejemplo ficticio: un formulario tiene nombre, correo electrónico y mensaje. Falta el nombre y la dirección está incompleta; el mensaje ya es válido. La primera comprobación debe señalar 2 errores, no 3. Corregir solo el nombre deja 1 error; corregir también la dirección no deja ninguno. Compare en cada paso el resumen, los errores locales y los valores conservados, sin obligar a escribir de nuevo el mensaje.

En este contrato de prueba, cada enlace del resumen lleva al campo afectado; aria-describedby asocia la explicación al control y aria-invalid indica su estado no válido. Tras corregirlo, retire la asociación al error obsoleto y conserve las instrucciones útiles. Una caída del servicio después de validar no es otro error de entrada ni demuestra que se haya guardado la solicitud. La tabla distingue 0 errores de campo de un envío realmente confirmado.

  • Mensajes de resumen y de campo.
  • Asociaciones de errores accesibles.
  • Enfoque y contraste probado.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Corrección progresiva de dos errores: prueba ficticia
Paso de la pruebaErrores de campo restantesResultado esperado
Primera comprobación2: nombre y correo electrónicoMensaje conservado; ambos errores accesibles
Solo el nombre corregido1: correo electrónicoError del nombre eliminado; el otro permanece
Dirección corregida también0Campos válidos; guardado aún por verificar
Servicio no disponible tras validar0; incidencia de servicio aparteSin falsa confirmación; recuperación explicada
  • W3C WAI : User Notification

    W3C WAI, consultado el 22 de octubre de 2026: notificaciones de formularios. Los campos y pasos son un ejemplo didáctico ficticio.

Preservar la entrada y la intención

Mantenga los valores válidos después de un error, excepto los datos confidenciales que no se deben volver a mostrar. Una forma larga debe dejar que alguien se reanude en su lugar. Un archivo rechazado necesita una explicación de formato o tamaño.

Distingue errores de validación, retrasos en la red y envío duplicado. Los clics repetidos no deben crear múltiples solicitudes ni pedidos. La confirmación debe decir si la acción fue realmente grabada.

  • Campos válidos retenidos.
  • Las fallas de la red se manejan claramente.
  • Envíos duplicados controlados.

Prueba casos reales

Pruebe campos vacíos, caracteres acentuados, correo electrónico mal escrito, archivo de gran tamaño, sesión caducada y servidor no disponible. Pregúntele a alguien que no esté familiarizado con el formulario que se recupere sin ayuda y observe vacilación.

Después de la corrección, revise el correo electrónico o el siguiente paso, no solo el mensaje en pantalla. El contenido de la confirmación y del error también necesita ser revisado en todos los idiomas publicados.

  • Errores representativos cubiertos.
  • Viaje completo comprobado.
  • Mensajes traducidos y revisados.

Corregir un campo sin perder los demás

Bolígrafo, formulario vacío y cuadrícula de calendario sobre una mesa
Ilustración generada por IA · Corrija un campo sin borrar los datos ya introducidos.

Caso propuesto: una fecha inválida borra el resto del formulario. La persona debe reconstruir su solicitud.

Pruebe errores y reintentos con datos ficticios. Compruebe conservación de valores, asociación del mensaje al campo y posibilidad de corregir sin adivinar.

  • Provocar un error conocido
  • Comprobar los valores conservados
  • Reintentar la solicitud

Documentos de referencia

Contenido actualizado

Referencias documentadas para este tema

Referencias documentadas para este tema
ReferenciaValor o sintaxisAlcance
WCAG 2.2 · 1.4.10
320 CSS pxContenido vertical sin desplazamiento en dos dimensiones; excepciones para contenido intrínsecamente bidimensional.
WCAG 2.2 · 2.5.8
24 × 24 CSS pxUn objetivo menor puede cumplir el criterio mediante el espaciado; existen otras excepciones.
WCAG 2.2 · 3.3.7
A · same processEn un mismo proceso, la información ya facilitada debe rellenarse automáticamente o estar disponible para seleccionarla, salvo las excepciones del criterio. El autocompletado del navegador no basta: el sitio debe ofrecer los datos recibidos o evitar solicitarlos de nuevo.

Las fechas indican la consulta de las referencias. Estos datos no constituyen una auditoría ni una declaración global de conformidad.

Matriz de validación funcional para adaptarse al proyecto

Estos controles propuestos utilizan casos ficticios. Decida qué comportamiento se espera con el equipo, anote el resultado y asigne discrepancias no resueltas antes de la publicación.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Casos de prueba, resultados esperados y evidencia útil
CasoResultado esperadoPrueba para mantener
Dos campos no son válidos después de la presentación.Cada error está asociado con su campo y el resumen ayuda a localizarlos.Registre la URL, los pasos, el resultado y la evidencia fechada.

Preguntas frecuentes

¿Dónde deberían aparecer errores de formulario útiles?

Asocie un mensaje preciso con su campo y proporcione un resumen de múltiples errores. Explicar la corrección sin detalles internos. Conserve la entrada útil y verifique el teclado y la lectura asistida. El color por sí solo no puede identificar el problema.

¿Qué mensaje mostrar si falla el envío pero los campos son válidos?

Distinguir entrada inválida, servicio no disponible y resultado aún desconocido tras una interrupción. No pedir corregir un campo aceptado. Conservar los valores útiles y explicar la recuperación prevista. Si el servidor pudo guardar la solicitud antes del corte, comprobar su resultado según el contrato del servicio antes de presentar un nuevo envío como libre de efectos adicionales.