Patrones de Auditoría WCAG
Guía completa para auditar contenido web según las pautas WCAG 2.2 con estrategias de corrección accionables.
Cuándo usar este skill
- Realizar auditorías de accesibilidad
- Corregir violaciones WCAG
- Implementar componentes accesibles
- Prepararse para demandas de accesibilidad
- Cumplir con requisitos ADA/Sección 508
- Lograr conformidad VPAT
Conceptos fundamentales
1. Niveles de conformidad WCAG
| Nivel | Descripción | Requerido para |
|---|---|---|
| A | Accesibilidad mínima | Base legal |
| AA | Conformidad estándar | La mayoría de regulaciones |
| AAA | Accesibilidad mejorada | Necesidades especializadas |
2. Principios POUR
Perceptible: ¿Pueden los usuarios percibir el contenido?
Operable: ¿Pueden los usuarios operar la interfaz?
Comprensible: ¿Pueden los usuarios comprender el contenido?
Robusto: ¿Funciona con tecnología de asistencia?
3. Violaciones comunes por impacto
Críticas (Bloqueantes):
├── Falta de texto alternativo en imágenes funcionales
├── Sin acceso por teclado a elementos interactivos
├── Etiquetas de formulario faltantes
└── Multimedia que se reproduce automáticamente sin controles
Graves:
├── Contraste de color insuficiente
├── Enlaces de salto faltantes
├── Widgets personalizados inaccesibles
└── Títulos de página faltantes
Moderadas:
├── Atributo de lenguaje faltante
├── Texto de enlace poco claro
├── Hitos (landmarks) faltantes
└── Jerarquía de encabezados incorrecta
Lista de verificación de auditoría
Perceptible (Principio 1)
## 1.1 Alternativas textuales
### 1.1.1 Contenido no textual (Nivel A)
- [ ] Todas las imágenes tienen texto alternativo
- [ ] Las imágenes decorativas tienen alt=""
- [ ] Las imágenes complejas tienen descripciones largas
- [ ] Los iconos con significado tienen nombres accesibles
- [ ] Los CAPTCHA tienen alternativas
Verificar:
```html
<!-- Correcto -->
<img src="grafico.png" alt="Las ventas aumentaron un 25% del Q1 al Q2" />
<img src="linea-decorativa.png" alt="" />
<!-- Incorrecto -->
<img src="grafico.png" />
<img src="linea-decorativa.png" alt="línea decorativa" />
```
1.2 Medios basados en tiempo
1.2.1 Solo audio y solo video (Nivel A)
- El audio tiene transcripción textual
- El video tiene descripción de audio o transcripción
1.2.2 Subtítulos (Nivel A)
- Todo video tiene subtítulos sincronizados
- Los subtítulos son precisos y completos
- Identificación de hablantes incluida
1.2.3 Descripción de audio (Nivel A)
- El video tiene descripción de audio para contenido visual
1.3 Adaptable
1.3.1 Información y relaciones (Nivel A)
- Los encabezados usan etiquetas adecuadas (h1-h6)
- Las listas usan ul/ol/dl
- Las tablas tienen encabezados
- Las entradas de formulario tienen etiquetas
- Los hitos ARIA están presentes
Verificar:
<!-- Jerarquía de encabezados -->
<h1>Título de página</h1>
<h2>Sección</h2>
<h3>Subsección</h3>
<h2>Otra sección</h2>
<!-- Encabezados de tabla -->
<table>
<thead>
<tr>
<th scope="col">Nombre</th>
<th scope="col">Precio</th>
</tr>
</thead>
</table>
1.3.2 Secuencia significativa (Nivel A)
- El orden de lectura es lógico
- El posicionamiento CSS no rompe el orden
- El orden de enfoque coincide con el orden visual
1.3.3 Características sensoriales (Nivel A)
- Las instrucciones no dependen solo de forma/color
- "Haz clic en el botón rojo" → "Haz clic en Enviar (botón rojo)"
1.4 Distinguible
1.4.1 Uso del color (Nivel A)
- El color no es el único medio para transmitir información
- Los enlaces se distinguen sin color
- Los estados de error no solo usan color
1.4.3 Contraste (mínimo) (Nivel AA)
- Texto: relación de contraste 4.5:1
- Texto grande (18pt+): relación 3:1
- Componentes de IU: relación 3:1
Herramientas: WebAIM Contrast Checker, axe DevTools
1.4.4 Redimensionar texto (Nivel AA)
- El texto se redimensiona al 200% sin pérdida
- Sin desplazamiento horizontal a 320px
- El contenido se reordena correctamente
1.4.10 Reflujo (Nivel AA)
- El contenido se reordena al 400% de zoom
- Sin desplazamiento bidimensional
- Todo el contenido accesible a 320px de ancho
1.4.11 Contraste de no texto (Nivel AA)
- Los componentes de IU tienen contraste 3:1
- Los indicadores de enfoque son visibles
- Los objetos gráficos se distinguen
1.4.12 Espaciado de texto (Nivel AA)
- Sin pérdida de contenido con espaciado aumentado
- Altura de línea 1.5x tamaño de fuente
- Espaciado de párrafo 2x tamaño de fuente
- Espaciado entre letras 0.12x tamaño de fuente
- Espaciado entre palabras 0.16x tamaño de fuente
### Operable (Principio 2)
```markdown
## 2.1 Accesible por teclado
### 2.1.1 Teclado (Nivel A)
- [ ] Toda funcionalidad accesible por teclado
- [ ] Sin trampas de teclado
- [ ] El orden de tabulación es lógico
- [ ] Los widgets personalizados son operables por teclado
Verificar:
```javascript
// El botón personalizado debe ser accesible por teclado
<div role="button" tabindex="0"
onkeydown="if(event.key === 'Enter' || event.key === ' ') activar()">
```
### 2.1.2 Sin trampa de teclado (Nivel A)
- [ ] El enfoque puede salir de todos los componentes
- [ ] Los diálogos modales capturan el enfoque correctamente
- [ ] El enfoque regresa después de cerrar el modal
## 2.2 Tiempo suficiente
### 2.2.1 Tiempo ajustable (Nivel A)
- [ ] Los tiempos de sesión se pueden extender
- [ ] El usuario es advertido antes del tiempo de espera
- [ ] Opción para deshabilitar la actualización automática
### 2.2.2 Pausar, Detener, Ocultar (Nivel A)
- [ ] El contenido en movimiento se puede pausar
- [ ] El contenido que se actualiza automáticamente se puede pausar
- [ ] Las animaciones respetan prefers-reduced-motion
```css
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
}
}
```
## 2.3 Convulsiones y reacciones físicas
### 2.3.1 Tres destellos (Nivel A)
- [ ] Ningún contenido destella más de 3 veces/segundo
- [ ] El área de destello es pequeña (<25% del viewport)
## 2.4 Navegable
### 2.4.1 Omitir bloques (Nivel A)
- [ ] Enlace para saltar al contenido principal presente
- [ ] Regiones de hito (landmark) definidas
- [ ] Estructura de encabezados adecuada
```html
<a href="#main" class="skip-link">Saltar al contenido principal</a>
<main id="main">...</main>
```
### 2.4.2 Página con título (Nivel A)
- [ ] Títulos de página únicos y descriptivos
- [ ] El título refleja el contenido de la página
### 2.4.3 Orden de enfoque (Nivel A)
- [ ] El orden de enfoque coincide con el orden visual
- [ ] tabindex usado correctamente
### 2.4.4 Propósito del enlace (en contexto) (Nivel A)
- [ ] Los enlaces tienen sentido fuera de contexto
- [ ] Sin "haz clic aquí" o "leer más" solos
```html
<!-- Incorrecto -->
<a href="reporte.pdf">Haz clic aquí</a>
<!-- Correcto -->
<a href="reporte.pdf">Descargar Reporte de Ventas Q4 (PDF)</a>
```
### 2.4.6 Encabezados y etiquetas (Nivel AA)
- [ ] Los encabezados describen el contenido
- [ ] Las etiquetas describen el propósito
### 2.4.7 Enfoque visible (Nivel AA)
- [ ] Indicador de enfoque visible en todos los elementos
- [ ] Los estilos de enfoque personalizados cumplen con el contraste
```css
:focus {
outline: 3px solid #005fcc;
outline-offset: 2px;
}
```
### 2.4.11 Enfoque no oscurecido (Nivel AA) - WCAG 2.2
- [ ] El elemento enfocado no está completamente oculto
- [ ] Los encabezados fijos no ocultan el enfoque
```
### Comprensible (Principio 3)
```markdown
## 3.1 Legible
### 3.1.1 Idioma de la página (Nivel A)
- [ ] Atributo lang de HTML establecido
- [ ] Idioma correcto para el contenido
```html
<html lang="es">
```
### 3.1.2 Idioma de las partes (Nivel AA)
- [ ] Cambios de idioma marcados
```html
<p>La palabra francesa <span lang="fr">bonjour</span> significa hola.</p>
```
## 3.2 Predecible
### 3.2.1 Al recibir el enfoque (Nivel A)
- [ ] Sin cambio de contexto solo por enfoque
- [ ] Sin ventanas emergentes inesperadas al enfocar
### 3.2.2 Al ingresar datos (Nivel A)
- [ ] Sin envío automático de formularios
- [ ] Usuario advertido antes de un cambio de contexto
### 3.2.3 Navegación consistente (Nivel AA)
- [ ] Navegación consistente en todas las páginas
- [ ] Componentes repetidos en el mismo orden
### 3.2.4 Identificación consistente (Nivel AA)
- [ ] Misma funcionalidad = misma etiqueta
- [ ] Iconos usados de manera consistente
## 3.3 Asistencia para la entrada de datos
### 3.3.1 Identificación de errores (Nivel A)
- [ ] Errores claramente identificados
- [ ] El mensaje de error describe el problema
- [ ] Error vinculado al campo
```html
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Por favor ingresa un correo electrónico válido</span>
```
### 3.3.2 Etiquetas o instrucciones (Nivel A)
- [ ] Todas las entradas tienen etiquetas visibles
- [ ] Campos obligatorios indicados
- [ ] Sugerencias de formato proporcionadas
### 3.3.3 Sugerencia de error (Nivel AA)
- [ ] Los errores incluyen sugerencia de corrección
- [ ] Las sugerencias son específicas
### 3.3.4 Prevención de errores (Nivel AA)
- [ ] Formularios legales/financieros reversibles
- [ ] Datos verificados antes del envío
- [ ] Usuario puede revisar antes de enviar
Robusto (Principio 4)
## 4.1 Compatible
### 4.1.1 Procesamiento (Nivel A) - Obsoleto en WCAG 2.2
- [ ] HTML válido (buena práctica)
- [ ] Sin IDs duplicados
- [ ] Etiquetas de apertura/cierre completas
### 4.1.2 Nombre, rol, valor (Nivel A)
- [ ] Los widgets personalizados tienen nombres accesibles
- [ ] Roles ARIA correctos
- [ ] Los cambios de estado se anuncian
```html
<!-- Casilla de verificación personalizada accesible -->
<div role="checkbox"
aria-checked="false"
tabindex="0"
aria-labelledby="label">
</div>
<span id="label">Aceptar términos</span>
4.1.3 Mensajes de estado (Nivel AA)
- Las actualizaciones de estado se anuncian
- Las regiones en vivo se usan correctamente
<div role="status" aria-live="polite">3 artículos agregados al carrito</div>
<div role="alert" aria-live="assertive">Error: El envío del formulario falló</div>
## Pruebas automatizadas
```javascript
// Integración con axe-core
const axe = require('axe-core');
async function ejecutarAuditoriaAccesibilidad(page) {
await page.addScriptTag({ path: require.resolve('axe-core') });
const results = await page.evaluate(async () => {
return await axe.run(document, {
runOnly: {
type: 'tag',
values: ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa']
}
});
});
return {
violations: results.violations,
passes: results.passes,
incomplete: results.incomplete
};
}
// Ejemplo de prueba con Playwright
test('no debe tener violaciones de accesibilidad', async ({ page }) => {
await page.goto('/');
const results = await ejecutarAuditoriaAccesibilidad(page);
expect(results.violations).toHaveLength(0);
});
```
```bash
# Herramientas CLI
npx @axe-core/cli https://example.com
npx pa11y https://example.com
lighthouse https://example.com --only-categories=accessibility
```
## Patrones de corrección
### Corrección: Etiquetas de formulario faltantes
```html
<!-- Antes -->
<input type="email" placeholder="Correo electrónico" />
<!-- Después: Opción 1 - Etiqueta visible -->
<label for="email">Dirección de correo electrónico</label>
<input id="email" type="email" />
<!-- Después: Opción 2 - aria-label -->
<input type="email" aria-label="Dirección de correo electrónico" />
<!-- Después: Opción 3 - aria-labelledby -->
<span id="email-label">Correo electrónico</span>
<input type="email" aria-labelledby="email-label" />
```
### Corrección: Contraste de color insuficiente
```css
/* Antes: 2.5:1 de contraste */
.text {
color: #767676;
}
/* Después: 4.5:1 de contraste */
.text {
color: #595959;
}
/* O agregar fondo */
.text {
color: #767676;
background: #000;
}
```
### Corrección: Navegación por teclado
```javascript
// Hacer que un elemento personalizado sea accesible por teclado
class DropdownAccesible extends HTMLElement {
connectedCallback() {
this.setAttribute("tabindex", "0");
this.setAttribute("role", "combobox");
this.setAttribute("aria-expanded", "false");
this.addEventListener("keydown", (e) => {
switch (e.key) {
case "Enter":
case " ":
this.alternar();
e.preventDefault();
break;
case "Escape":
this.cerrar();
break;
case "ArrowDown":
this.enfocarSiguiente();
e.preventDefault();
break;
case "ArrowUp":
this.enfocarAnterior();
e.preventDefault();
break;
}
});
}
}
```
## Buenas prácticas
### Hacer
- **Empezar temprano** - Accesibilidad desde la fase de diseño
- **Probar con usuarios reales** - Los usuarios con discapacidad brindan la mejor retroalimentación
- **Automatizar lo que puedas** - 30-50% de los problemas detectables
- **Usar HTML semántico** - Reduce la necesidad de ARIA
- **Documentar patrones** - Construir una biblioteca de componentes accesibles
### No hacer
- **No confiar solo en pruebas automatizadas** - Se requieren pruebas manuales
- **No usar ARIA como primera solución** - Priorizar HTML nativo
- **No ocultar los contornos de enfoque** - Los usuarios de teclado los necesitan
- **No deshabilitar el zoom** - Los usuarios necesitan redimensionar
- **No usar solo color** - Se necesitan múltiples indicadores
## Recursos
- [Pautas WCAG 2.2](https://www.w3.org/TR/WCAG22/)
- [WebAIM](https://webaim.org/)
- [Lista de verificación del Proyecto A11y](https://www.a11yproject.com/checklist/)
- [axe DevTools](https://www.deque.com/axe/)

