# Identificación de errores: mensajes claros en formularios

Source: https://allyway.ai/es/glossary/identificacion-de-errores

La identificación de errores significa que, cuando un sitio web detecta automáticamente un error de entrada, señala el campo con el error y describe el problema al usuario mediante texto. La exige el criterio WCAG 3.3.1 en el nivel A.

La identificación de errores es lo que ocurre cuando un formulario rechaza un dato e indica exactamente qué campo es incorrecto y por qué, con palabras y no solo con un borde rojo. Si un proceso de pago se limita a recargarse con los mismos campos y sin ningún mensaje, muchos usuarios no saben qué ha fallado y lo abandonan. Los mensajes de error claros convierten un envío fallido en una corrección rápida.

## Qué significa

El criterio [WCAG 3.3.1 Identificación de errores](https://www.w3.org/WAI/WCAG22/Understanding/error-identification.html) (nivel A, [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2)) exige que, si se detecta automáticamente un error de entrada, se identifique el elemento con el error y se describa el error al usuario mediante texto. Se piden dos cosas: que se identifique el campo con el error y que la naturaleza del problema se describa con texto.

Un error de entrada abarca dos casos: la información obligatoria que se ha omitido y la información que no respeta el formato requerido o los valores permitidos. El criterio solo se aplica cuando es el propio sitio web el que detecta el error, mediante validación en el cliente o en el servidor. Si la página corrige en silencio un valor fuera de rango, hay que informar igualmente a los usuarios del cambio.

| Situación | Resultado |
|---|---|
| Mensaje «Dirección de correo electrónico: introduzca una dirección como nombre@example.com» junto al campo | Cumple: campo identificado, error en texto |
| Resumen de errores al principio del formulario que nombra cada campo | Cumple: el W3C admite una lista, un texto junto al campo o un cuadro de diálogo |
| Solo un borde rojo alrededor del campo | No cumple: el color no es texto |
| El formulario se recarga con los valores anteriores y sin ningún mensaje | No cumple: nada le dice al usuario qué ha fallado |
| Icono con «!» y sin alternativa textual | No cumple: el error no se describe con texto |

> **Note:** > **El color puede ayudar, el texto es obligatorio**
> Los bordes rojos, los iconos y las imágenes son bienvenidos como señales adicionales. Las personas ciegas, con baja visión o con deficiencia en la visión del color siguen necesitando el error en forma de texto. Procure también que el texto sea legible: el rojo de los errores a menudo no alcanza el [contraste de color](https://allyway.ai/es/glossary/contraste-de-color) necesario.

El criterio 3.3.1 no exige que el campo se marque en el código, pero el W3C remite al 4.1.2 para eso. Indicar a los usuarios cómo corregir el dato corresponde a las [sugerencias ante errores](https://allyway.ai/es/glossary/sugerencias-ante-errores) (3.3.3).

## Ejemplos

```html title="Ejemplo"
<label for="email">Email address (required)</label>
<input id="email" type="email" aria-invalid="true" aria-describedby="email-error">
<p id="email-error">Error: The email address is missing an @ sign.</p>

<!-- Error summary, announced when it appears -->
<div role="alert">
  <h2>2 problems with your order</h2>
  <ul>
    <li><a href="#email">Email address: the @ sign is missing</a></li>
    <li><a href="#zip">Postal code: please enter 5 digits</a></li>
  </ul>
</div>
```

El mensaje se conecta con el campo mediante `aria-describedby`, `aria-invalid="true"` (técnica ARIA21) marca el campo y `role="alert"` (ARIA19) hace que los [lectores de pantalla](https://allyway.ai/es/glossary/lector-de-pantalla) anuncien el resumen. Más sobre cómo anunciar los cambios en las [regiones vivas ARIA](https://allyway.ai/es/glossary/regiones-vivas-aria).

**Do:** Qué hacer

Nombre el campo y el problema con palabras sencillas («Código postal: introduzca 5 dígitos»), muestre el mensaje junto al campo y, en los formularios largos, también en un resumen con enlaces a cada campo. Conserve los datos que ha introducido el usuario.

**Don't:** Qué evitar

Confiar solo en un contorno rojo o en un icono, mostrar un «Entrada no válida» genérico sin decir dónde, vaciar todo el formulario tras un error o quitar el mensaje antes de que las personas hayan tenido tiempo de leerlo.

## Cómo comprobar la identificación de errores



## Preguntas frecuentes

Q: ¿Basta con un borde rojo para mostrar un error de formulario?
A: No. El criterio WCAG 3.3.1 exige que el error se describa con texto. El borde rojo puede quedarse como señal adicional, pero añada un mensaje como «Número de teléfono: utilice solo dígitos».

Q: ¿Dónde deben aparecer los mensajes de error?
A: El W3C no prescribe un lugar: junto al campo, una lista al principio del formulario o una alerta sirven por igual. En los formularios más largos, combine ambos: un resumen con enlaces y un mensaje en cada campo.

Q: ¿Se aplica el criterio WCAG 3.3.1 a los campos obligatorios?
A: Sí. Omitir información obligatoria es uno de los dos tipos de error de entrada que cubre el criterio. Indique qué campo falta y marque los campos obligatorios en la etiqueta antes de que la gente empiece a escribir.

Q: ¿Tienen que anunciar los lectores de pantalla los mensajes de error?
A: El criterio 3.3.1 pide el error en forma de texto. Conseguir que se anuncie un mensaje nuevo sin mover el foco corresponde al criterio 4.1.3 Mensajes de estado, por ejemplo con role="alert" o una región viva.
