Auditor de Accesibilidad
Audita aplicaciones web para verificar el cumplimiento con las pautas de accesibilidad (WCAG 2.1 Nivel AA) y sugiere mejoras.
Cuándo Usarlo
- Al construir o revisar componentes de UI
- Cuando un usuario solicita mejoras de accesibilidad
- Al prepararse para una auditoría de accesibilidad
- Cuando el usuario menciona "accesibilidad", "a11y", "WCAG", "lector de pantalla" o "navegación por teclado"
Instrucciones
1. Verificación de HTML Semántico
Usa elementos HTML adecuados:
<!-- Malo -->
<div onclick="submit()">Enviar</div>
<!-- Bueno -->
<button onclick="submit()">Enviar</button>
Estructura semántica:
<header>,<nav>,<main>,<footer><article>,<section>,<aside><h1>a<h6>en jerarquía adecuada<button>para acciones,<a>para navegación
2. Atributos ARIA
Cuándo usar ARIA:
- Widgets personalizados (pestañas, acordeones, modales)
- Actualizaciones de contenido dinámico
- Interacciones complejas
- Cuando el HTML semántico no es suficiente
Atributos ARIA comunes:
<!-- Roles de punto de referencia -->
<nav role="navigation" aria-label="Principal">
<!-- Roles de widget -->
<div role="button" tabindex="0" aria-pressed="false">
<!-- Regiones vivas -->
<div role="alert" aria-live="assertive">Ocurrió un error</div>
<!-- Etiquetas y descripciones -->
<button aria-label="Cerrar diálogo">×</button>
<input aria-describedby="ayuda-contraseña" />
Primera regla de ARIA: No uses ARIA si el HTML semántico funciona
3. Navegación por Teclado
Todos los elementos interactivos deben ser accesibles por teclado:
// Agregar soporte de teclado a elementos personalizados
<div
role="button"
tabindex="0"
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
handleClick();
}
}}
>
Haz clic aquí
</div>
Orden de tabulación:
- Usa
tabindex="0"para elementos interactivos personalizados - Evita
tabindex > 0(crea un orden de tabulación confuso) - Usa
tabindex="-1"solo para enfoque programático
Gestión del enfoque:
- Indicadores de enfoque visibles
- Atrapar el enfoque en modales
- Devolver el enfoque al cerrar diálogos
- Enlaces de salto al contenido principal
4. Texto Alternativo e Imágenes
Imágenes informativas:
<img src="grafico.png" alt="Las ventas aumentaron un 25% en el tercer trimestre" />
Imágenes decorativas:
<img src="decoracion.png" alt="" />
<!-- o -->
<img src="decoracion.png" role="presentation" />
Imágenes complejas:
<figure>
<img src="grafico-complejo.png" alt="Gráfico de ventas trimestral" />
<figcaption>
Descripción detallada de los datos del gráfico...
</figcaption>
</figure>
5. Color y Contraste
Relaciones de contraste (WCAG AA):
- Texto normal: mínimo 4.5:1
- Texto grande (18pt+): mínimo 3:1
- Componentes de UI: mínimo 3:1
No confíes solo en el color:
<!-- Malo: Solo color -->
<span style="color: red;">Error</span>
<!-- Bueno: Icono + color -->
<span style="color: red;">
<svg aria-hidden="true"><!-- icono de error --></svg>
<span class="sr-only">Error: </span>
Entrada no válida
</span>
6. Formularios y Etiquetas
Cada entrada necesita una etiqueta:
<!-- Etiqueta explícita -->
<label for="email">Correo electrónico</label>
<input id="email" type="email" />
<!-- Etiqueta implícita -->
<label>
Correo electrónico
<input type="email" />
</label>
<!-- aria-label para botones de icono -->
<button aria-label="Buscar">
<svg><!-- icono de búsqueda --></svg>
</button>
Mensajes de error:
<input
id="contraseña"
aria-invalid="true"
aria-describedby="error-contraseña"
/>
<div id="error-contraseña" role="alert">
La contraseña debe tener al menos 8 caracteres
</div>
7. Encabezados y Estructura del Documento
Jerarquía adecuada de encabezados:
<h1>Título de la Página</h1>
<h2>Sección 1</h2>
<h3>Subsección 1.1</h3>
<h3>Subsección 1.2</h3>
<h2>Sección 2</h2>
No saltes niveles: h1 → h2 → h3 (no h1 → h3)
8. Contenido Dinámico
Anuncia actualizaciones a los lectores de pantalla:
<!-- Cortés: esperar a que el usuario haga una pausa -->
<div role="status" aria-live="polite">
5 mensajes nuevos
</div>
<!-- Asertivo: interrumpir de inmediato -->
<div role="alert" aria-live="assertive">
Tu sesión expirará en 1 minuto
</div>
Estados de carga:
<button aria-busy="true" aria-label="Cargando...">
<span aria-hidden="true">Cargando</span>
</button>
9. Pruebas con Lectores de Pantalla
Texto solo para lectores de pantalla:
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
Oculta elementos decorativos:
<svg aria-hidden="true"><!-- icono --></svg>
10. Problemas Comunes a Revisar
Faltantes:
- Texto alternativo en imágenes
- Etiquetas en entradas de formulario
- Jerarquía adecuada de encabezados
- Indicadores de enfoque de teclado
- Etiquetas ARIA en botones de icono
Inadecuados:
- Texto con bajo contraste
- Marcado no semántico (divs como botones)
- Gestión de enfoque ausente en modales
- Trampas de teclado
- Reproducción automática de medios
Pruebas:
- Navegación solo con teclado
- Lector de pantalla (NVDA, JAWS, VoiceOver)
- Simulación de daltonismo
- Zoom al 200%
- Herramientas automatizadas (axe, Lighthouse)
11. Pruebas Automatizadas
Herramientas:
# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility
# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com
# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com
En pruebas:
import { axe } from 'jest-axe';
test('no debe tener violaciones de accesibilidad', async () => {
const { container } = render(<MyComponent />);
const results = await axe(container);
expect(results).toHaveNoViolations();
});
12. Lista de Verificación WCAG 2.1 Nivel AA
Perceptible:
- Alternativas textuales para contenido no textual
- Subtítulos para audio/video
- Contenido adaptable (marcado semántico)
- Contraste de color suficiente
Operable:
- Accesible por teclado
- Sin trampas de teclado
- Límites de tiempo adecuados (ajustables)
- Sin parpadeos que induzcan convulsiones
- Enlaces para saltar navegación
- Títulos de página descriptivos
- El orden de enfoque tiene sentido
- Propósito del enlace claro desde el contexto
Comprensible:
- Idioma de la página especificado (
<html lang="es">) - Navegación predecible
- Asistencia en la entrada (etiquetas, instrucciones, mensajes de error)
Robusto:
- HTML válido
- Nombre, rol y valor para widgets personalizados
- Compatible con tecnologías de asistencia
Mejores Prácticas
- Construye la accesibilidad desde el principio
- Prueba con tecnologías de asistencia reales
- Usa HTML semántico primero, ARIA después
- Mantén una estructura de documento lógica
- Proporciona múltiples formas de acceder al contenido
- Prueba la navegación por teclado a fondo
- No deshabilites el zoom
- Usa puntos de referencia y encabezados
Archivos de Apoyo
reference/wcag-checklist.md: Lista de verificación completa de WCAG 2.1 AAreference/aria-patterns.md: Patrones comunes de widgets ARIA


