Saltar al contenido

Formularios accesibles: 6 errores que fallan WCAG 2.2 y cómo arreglarlos

En la práctica/ 15 min de lectura

Seis errores de formulario que fallan WCAG 2.2, con su criterio y nivel, código HTML, CSS y JavaScript probado con Playwright y axe-core, y lo que axe no detecta.

  • JavaScript
  • CRO
  • QA
En este artículo (11)
  1. Qué pide WCAG 2.2 a un formulario
  2. El placeholder no es una etiqueta
  3. Errores que no dependen solo del color
  4. Mensajes que el lector de pantalla anuncia
  5. Foco visible y no tapado
  6. Objetivos de 24 px
  7. No pedir lo mismo dos veces
  8. Cómo probar formularios accesibles
  9. Errores comunes
  10. Preguntas frecuentes
  11. Checklist

Los formularios accesibles según WCAG 2.2 tienen una etiqueta visible en cada campo, errores escritos en texto y no solo en rojo, mensajes que el lector de pantalla anuncia, foco que ninguna barra fija tapa, objetivos de al menos 24 × 24 px y no piden dos veces el mismo dato en el mismo proceso.

Abajo tienes cada error con su criterio y su nivel, tomados de WCAG 2.2 (la Recomendación vigente del W3C, del 12 de diciembre de 2024), el código que lo arregla y lo que salió al probarlo: cargamos en Chromium con Playwright un checkout de prueba con los seis errores y otro corregido, y les pasamos axe-core.

Qué pide WCAG 2.2 a un formulario

WCAG 2.2 añadió criterios a los de 2.1 y retiró uno, 4.1.1 Parsing. Según el propio W3C, lo que cumple 2.2 también cumple 2.0 y 2.1. Tres de los criterios nuevos afectan a cualquier formulario de compra: 2.4.11, 2.5.8 y 3.3.7. Los demás de esta tabla vienen de versiones anteriores y siguen siendo los que más fallan en campos y mensajes de error. Si te piden nivel AA, tienes que cumplir los de nivel A y los de AA.

CriterioNivelQué pideError típico
1.3.1 Info and RelationshipsALa estructura que se ve también se puede determinar por códigoCampo sin <label> asociado
1.4.1 Use of ColorAEl color no es el único medio visual para dar informaciónError marcado solo con un borde rojo
2.4.11 Focus Not Obscured (Minimum)AA (nuevo)El componente con foco no queda oculto por completo por contenido del sitioBarra fija o banner de cookies encima del campo
2.5.8 Target Size (Minimum)AA (nuevo)Objetivos de al menos 24 × 24 px CSS, con excepcionesCasilla de 13 px pegada a otro control
3.3.1 Error IdentificationAEl campo con error se identifica y el error se describe en texto"Revisa el formulario" sin decir qué campo
3.3.7 Redundant EntryA (nuevo)Lo ya escrito en el mismo proceso se rellena solo o se puede elegirVolver a pedir la dirección para facturar
4.1.3 Status MessagesAALos mensajes de estado se anuncian sin recibir el focoResumen de errores que el lector no lee
un formulario con los seis errores marcadosEmail106702 3FacturaciónCalle y número6aceptoPagar5Total · barra fija4errorcriterio1placeholder en vez de etiqueta3.3.2 A2error marcado solo con color1.4.1 A3error que el lector no anuncia4.1.3 AA4foco tapado por la barra fija2.4.11 AA5objetivos de menos de 24 px2.5.8 AA6piden otra vez la dirección3.3.7 Aseis fallos en un checkout de pruebaaxe-core 4.12.1 marcó 1 de los 6; los otros 5 se prueban a mano

Desliza la figura para verla completa

El placeholder no es una etiqueta

Un campo con solo placeholder="Email" se ve limpio y falla en la práctica. El tutorial de formularios del W3C lo dice sin rodeos: el placeholder no reemplaza a la etiqueta, los navegadores suelen pintarlo con poco contraste y desaparece en cuanto la persona empieza a escribir, así que ya no puede revisar qué le pedía cada campo antes de enviar. El criterio es 3.3.2 Labels or Instructions (A), y la unión entre etiqueta y campo es 1.3.1 Info and Relationships (A).

Un detalle de la prueba: en Chromium 151 el campo con solo placeholder sí recibió nombre accesible ("Email"), porque el navegador usa el placeholder como último recurso. Por eso axe-core 4.12.1 no lo marcó. Que la herramienta pase no quiere decir que el campo esté bien: la etiqueta visible sigue sin existir. Este es el campo corregido, extraído del archivo que probamos:

<form id="checkout" novalidate>
  <p id="form-status" role="status"></p>

  <label for="email">Email (required)</label>
  <input id="email" type="email" autocomplete="email" required
         aria-describedby="email-hint email-error"
         data-error="Error: enter an email like name@example.com.">
  <p id="email-hint">We send the order confirmation here.</p>
  <p id="email-error" class="error"></p>
  1. novalidate apaga las burbujas nativas del navegador para que el formulario muestre sus propios mensajes; required y type siguen validando.
  2. <p role="status"> es la región donde aparecerá el resumen de errores. Tiene que existir, vacía, desde que carga la página: el lector anuncia los cambios de una región que ya conoce.
  3. <label for="email"> es la etiqueta visible, unida al campo por el id. "(required)" va en texto, no como un asterisco de color.
  4. type="email" y autocomplete="email" dan el teclado correcto en el celular y dejan que el navegador rellene el dato.
  5. aria-describedby une al campo dos textos, la pista y el error, que el lector lee después de la etiqueta.
  6. data-error guarda el mensaje que mostrará el script: qué está mal y cómo se arregla.
  7. La pista se ve siempre; el párrafo del error empieza vacío.

El valor de autocomplete y el teclado de cada campo están en checkout móvil: autocomplete y el teclado correcto. Aquí usamos los mismos.

Errores que no dependen solo del color

1.4.1 Use of Color (A) pide que el color no sea el único medio visual para transmitir información. Un borde rojo sin texto no le dice nada a quien no distingue el rojo, ni a nadie con el celular al sol. 3.3.1 Error Identification (A) va más allá: si el error se detecta automáticamente, hay que identificar el campo y describir el error en texto. El arreglo junta tres señales: la palabra "Error:" con la explicación, un borde más grueso y aria-invalid="true" para el lector de pantalla.

const form = document.querySelector("#checkout");
const status = document.querySelector("#form-status");

function check(field) {
  const ok = field.checkValidity();
  field.setAttribute("aria-invalid", String(!ok));
  document.getElementById(field.id + "-error").textContent = ok ? "" : field.dataset.error;
  return ok;
}

form.addEventListener("change", (e) => {
  if (e.target.getAttribute("aria-invalid") === "true") check(e.target);
});

form.addEventListener("submit", (e) => {
  const fields = [...form.elements].filter((f) => f.dataset.error && f.willValidate);
  const bad = fields.filter((f) => !check(f));
  if (!bad.length) return;
  e.preventDefault();
  status.textContent = `${bad.length} field(s) need a fix. The first one has focus.`;
  bad[0].focus();
});
  1. check(field) valida un campo con checkValidity(), la API nativa que respeta required, type y pattern.
  2. Escribe aria-invalid como "true" o "false" según el resultado.
  3. Pone el texto de data-error en el párrafo de error, o lo vacía si el campo ya está bien. Hay que vaciarlo, no solo ocultarlo: en la prueba, Chromium siguió leyendo como descripción el texto de un párrafo con hidden referenciado por aria-describedby.
  4. El listener de change vuelve a validar solo los campos que ya estaban marcados: el error se quita en cuanto la persona lo corrige y no aparece mientras todavía escribe.
  5. En submit, el filtro toma los campos con mensaje propio que el navegador valida; willValidate es falso en los campos deshabilitados.
  6. Si hay errores, cancela el envío, escribe el resumen en la región de estado y lleva el foco al primer campo con error.

Mensajes que el lector de pantalla anuncia

4.1.3 Status Messages (AA) pide que los mensajes de estado se puedan determinar por su rol o sus propiedades, para que la tecnología de apoyo los presente sin que reciban el foco. En WAI-ARIA 1.2, role="status" tiene un aria-live implícito de polite: el lector termina lo que está diciendo y luego lee el cambio. El documento Understanding 4.1.3 lista como error usar role="alert" o aria-live="assertive" para contenido que no es importante ni urgente, así que el resumen va en status.

El resumen dice cuántos campos fallan. El error de cada campo llega por aria-describedby cuando el foco entra en él. Esto es lo que dio el árbol de accesibilidad de Chromium tras enviar el formulario vacío:

  • Formulario corregido: la región de estado decía "3 field(s) need a fix. The first one has focus."; el foco estaba en el email; su nombre era "Email (required)"; su descripción, la pista seguida de "Error: enter an email like name@example.com."; y su estado, inválido.
  • Formulario con los errores: nombre "Email" (sacado del placeholder), sin descripción, estado válido, ninguna región en vivo, y el foco se quedó en el botón. Visualmente, un borde rojo; para el lector, nada.
el mismo error, antes y despuésantesana.example.comsolo el borde rojonombre: Emaildescripción: (vacía)aria-invalid: falseregión de estado: ningunadespuésEmail (obligatorio)ana.example.comError: escribe un correo válidonombre: Email (obligatorio)descripción: pista + erroraria-invalid: truerole="status": 3 campostexto + borde + aria-invalid + aria-describedby + role=statuslo que ve la vista y lo que lee el lectorárbol de accesibilidad de Chromium 151 en los dos formularios

Desliza la figura para verla completa

Foco visible y no tapado

Son dos criterios. 2.4.7 Focus Visible (AA) pide que el indicador de foco se vea: un outline: none sin reemplazo lo rompe. 2.4.11 Focus Not Obscured (Minimum) (AA) es nuevo en 2.2: cuando un componente recibe el foco del teclado, no puede quedar oculto por completo por contenido del propio sitio. Según el documento Understanding 2.4.11, lo típico que tapa el foco son cabeceras fijas, pies fijos y diálogos no modales, y un banner de cookies que tapa por completo el componente con foco falla el criterio. El nivel AAA, 2.4.12, pide que no se tape ninguna parte.

Si arreglaste el CLS fijando el banner de cookies abajo, como en CLS: el banner de cookies que mueve toda tu página, ese banner es justo el contenido del que habla 2.4.11. El W3C da dos salidas: hacer el banner modal, para lo que sirve un modal accesible con dialog, o dejar espacio con scroll-padding, la técnica C43. Para una barra de total en el checkout, la segunda:

html { scroll-padding-bottom: 5rem; }   /* the fixed bar is 4rem tall */
body { padding-bottom: 5rem; }
:focus-visible { outline: 3px solid #135cfa; outline-offset: 2px; }
.total-bar { position: fixed; inset: auto 0 0; box-sizing: border-box; min-height: 4rem; }
  1. scroll-padding-bottom le dice al navegador que los últimos 5rem de la ventana no cuentan como visibles al desplazar un elemento hasta la vista, y eso incluye el campo que recibe el foco con Tab.
  2. El padding-bottom del body deja que el último control pueda subir por encima de la barra; sin él, el botón final se queda debajo aunque hagas scroll hasta el fondo.
  3. :focus-visible dibuja un contorno de 3px separado del campo, que se ve sobre el borde rojo de error.
  4. box-sizing: border-box hace que la barra mida exactamente 4rem. En la primera prueba no lo tenía: el relleno la dejó en 81px, uno más que el scroll-padding, y la casilla quedó un píxel debajo de la barra. Mide la barra y deja margen.

Con un recorrido con Tab en una ventana de 375 × 360, las siete paradas del formulario corregido quedaron por encima de la barra. En el formulario con los errores, el último código postal quedó tapado en parte, y la casilla y el botón Pagar por completo. Playwright ni siquiera pudo hacer clic en Pagar: la barra interceptaba el clic.

Objetivos de 24 px

2.5.8 Target Size (Minimum) (AA), nuevo en 2.2, pide que el objetivo de un puntero mida al menos 24 × 24 px CSS. Tiene cinco excepciones: espaciado (un círculo de 24 px centrado en el objetivo no toca otro objetivo), equivalente (otro control de la página hace lo mismo y cumple), en línea (un enlace dentro de una frase), control del agente de usuario (el navegador decide el tamaño y no lo cambiaste) y esencial. El nivel AAA, 2.5.5, sube a 44 × 44. Los detalles están en Understanding 2.5.8.

input, button { min-height: 44px; }
.check input { width: 24px; height: 24px; }
  1. Campos y botones miden al menos 44px de alto: pasan el mínimo de 24 y quedan cómodos para el pulgar.
  2. La casilla de "igual que el envío" mide 24 × 24. La etiqueta que la envuelve también la activa al hacer clic, pero no dependas de eso para el tamaño.

En el formulario con errores medimos una casilla de 13 × 13 y un botón Pagar de 33 × 22. axe-core dio por buena la regla target-size en los dos: no tenían otro objetivo cerca, así que aplicó la excepción de espaciado. Es correcto según el criterio, y frágil: en cuanto añadas un enlace al lado, deja de cumplir. Dales el tamaño y te olvidas.

No pedir lo mismo dos veces

3.3.7 Redundant Entry (A) pide que la información que la persona ya dio en el mismo proceso se rellene sola o se pueda elegir, salvo que repetirla sea esencial, sea necesaria por seguridad (una contraseña, por ejemplo) o ya no sea válida. El documento Understanding 3.3.7 aclara tres cosas: el autocompletado del navegador no cuenta, porque el que tiene que ofrecer el dato es el sitio; no obliga a guardar datos entre sesiones; y un paso de pago con un tercero dentro del checkout sí entra en el proceso. Su ejemplo es el de siempre: una casilla de "la dirección de facturación es la misma que la de envío".

<label class="check"><input id="same" type="checkbox" checked>
  Billing address is the same as shipping</label>

<fieldset id="billing" hidden disabled>
  <legend>Billing address</legend>
  <label for="bill-zip">Postal code (required)</label>
  <input id="bill-zip" autocomplete="billing postal-code" inputmode="numeric"
         required pattern="[0-9]{5}" data-copy="ship-zip"
         aria-describedby="bill-zip-error"
         data-error="Error: the postal code has 5 digits, for example 06700.">
  <p id="bill-zip-error" class="error"></p>
</fieldset>

<script>
const same = document.querySelector("#same");
const billing = document.querySelector("#billing");

same.addEventListener("change", () => {
  billing.hidden = billing.disabled = same.checked;
  // Unticked: start from the shipping address, not from empty fields.
  for (const f of billing.elements) f.value ||= form.elements[f.dataset.copy].value;
});
</script>
  1. La casilla viene marcada: en la mayoría de los pedidos, la persona no ve los campos de facturación.
  2. El fieldset empieza hidden y disabled. Deshabilitado, sus campos no se validan ni se envían.
  3. autocomplete="billing postal-code" distingue el código postal de facturación del de envío.
  4. data-copy dice de qué campo de envío sale el valor inicial.
  5. Al desmarcar la casilla, el script muestra y habilita el grupo, y cada campo vacío toma el valor de su par de envío con ||=, sin pisar lo que la persona ya cambió.

En la prueba escribimos "Av. Insurgentes 100" y "06700" en el envío (datos ilustrativos), desmarcamos la casilla y los dos campos de facturación aparecieron con esos valores. El archivo probado tiene también la calle de facturación; aquí se omite por espacio. Otro ejemplo del W3C que aplica a cualquier checkout: si la tarjeta falla, no borres lo que ya estaba escrito.

Cómo probar formularios accesibles

Corrimos los dos archivos en Chromium 151 con Playwright 1.62 y axe-core 4.12.1, con las etiquetas de reglas de WCAG 2.0 a 2.2 en A y AA más las buenas prácticas. Este es el resumen de lo que imprimió el script:

form-good.html
  axe, on load ............. 0 violations
  axe, errors shown ........ 0 violations
  axe, billing open ........ 0 violations
  Tab walk at 375x360 ...... 7 stops, none under the fixed bar
  targets under 24x24 ...... none
form-bad.html
  axe ...................... 1 violation: label (the bare checkbox)
  Tab walk at 375x360 ...... bill-zip partly, terms and Pay entirely hidden
  targets under 24x24 ...... terms 13x13, Pay 33x22 (axe: pass by spacing)
  1. El formulario corregido pasa axe en sus tres estados: al cargar, con errores y con la facturación abierta.
  2. El recorrido con Tab mide cada campo con foco contra la barra fija, en una ventana chica, donde el problema aparece.
  3. El formulario con los seis errores solo tiene una violación para axe: la casilla sin etiqueta. Los otros cinco errores no los detectó.
  4. El recorrido con Tab y la medida de objetivos son las comprobaciones que encontraron el foco tapado y los controles chicos.

Uno de seis. axe sirve para lo que se puede medir en el DOM, y lo demás lo pruebas tú: recorre el formulario solo con el teclado, envíalo vacío y escucha qué anuncia un lector de pantalla (NVDA en Windows, VoiceOver en macOS e iOS), y repite en una ventana chica con la barra o el banner visibles. Nosotros revisamos el árbol de accesibilidad de Chromium, no un lector de pantalla real; antes de publicar un checkout, haz esa última prueba.

criterio de WCAG 2.2 → arreglo en el formulariocriterionivelarreglo1.3.1A<label for> unido a cada campo1.4.1Ael texto «Error:» además del rojo2.4.11AAscroll-padding del alto de la barra fija2.5.8AA24 × 24 px como mínimo, o espacio alrededor3.3.1Ael campo y el error descritos en texto3.3.7Acasilla «igual que el envío» y datos copiados4.1.3AAresumen en role="status", sin mover el focotres criterios nuevos en 2.2: 2.4.11, 2.5.8, 3.3.7fuente: WCAG 2.2, Recomendación del W3C, 12 de diciembre de 2024

Desliza la figura para verla completa

Errores comunes

  • Dar por buena la etiqueta porque axe pasa. Chromium nombra el campo con el placeholder; la etiqueta visible sigue faltando.
  • Ocultar el error con hidden en vez de vaciarlo. aria-describedby lo sigue leyendo.
  • Crear la región de estado al mostrar el error. Debe existir antes; si aparece ya con texto, el lector puede no anunciarla.
  • Usar role="alert" para todo. Interrumpe al lector; el W3C lo reserva para lo importante y urgente.
  • Un scroll-padding menor que la barra. Nos pasó por un píxel. Mide la barra con el relleno incluido.
  • Quitar el outline sin poner otro indicador. Falla 2.4.7 aunque el campo no esté tapado.
  • Contar con el autocompletado del navegador para 3.3.7. El W3C dice que no basta: el sitio tiene que ofrecer el dato.

Preguntas frecuentes

¿WCAG 2.2 reemplaza a WCAG 2.1?

No las deja obsoletas, pero las cubre: según el W3C, el contenido que cumple 2.2 también cumple 2.0 y 2.1. Si hoy apuntas a 2.1 AA, sumar 2.4.11, 2.5.8 y 3.3.7 en tus formularios te deja en 2.2 en esa parte.

¿Basta con pasar axe o Lighthouse?

No. En nuestra prueba axe encontró uno de los seis errores. Las herramientas automáticas no saben si un borde rojo explica algo, si una barra tapa el foco al tabular o si el sitio vuelve a pedir un dato. Úsalas primero y luego prueba con teclado y lector de pantalla.

¿Uso aria-live o role="status"?

role="status" ya trae aria-live="polite" y aria-atomic="true" implícitos según WAI-ARIA 1.2, y además dice qué es. Para un resumen de errores es lo adecuado. role="alert" (asertivo) queda para mensajes urgentes.

¿El autocompletado del navegador cumple Redundant Entry?

No. El documento Understanding de 3.3.7 dice que no se considera suficiente, porque es el sitio el que debe ofrecer lo que la persona ya escribió en el mismo proceso. Usa autocomplete igual: ayuda a rellenar y cumple 1.3.5 Identify Input Purpose (AA).

Checklist

  • Cada campo tiene un <label> visible unido por for e id; el placeholder, si existe, solo da un ejemplo.
  • Los obligatorios lo dicen en texto.
  • Cada error lleva texto ("Error: …"), borde y aria-invalid="true".
  • El error está unido al campo con aria-describedby y se vacía al corregirlo.
  • La región role="status" existe vacía desde el inicio y recibe el resumen.
  • El foco va al primer campo con error.
  • :focus-visible tiene un contorno que se ve.
  • scroll-padding-bottom es mayor que la barra o el banner fijo.
  • Campos, botones y casillas miden al menos 24 × 24 px.
  • La facturación ofrece "igual que el envío" y copia los datos.
  • Pasaste axe, el recorrido con Tab en una ventana chica y un lector de pantalla.

Estos arreglos también ayudan a quien compra desde el celular con prisa. Si trabajas el checkout, empieza por los campos: autocomplete y teclado en el checkout móvil.

¿Viste esto en Instagram? Todas las guías de los Reels están en ecomlabs.dev/guias.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 19 de noviembre de 2026 · actualizado el 20 de noviembre de 2026

← Blog