/revisión-de-accesibilidad
Si ves marcadores de posición desconocidos o necesitas verificar qué herramientas están conectadas, consulta CONNECTORS.md.
Audita un diseño o página para verificar el cumplimiento de accesibilidad WCAG 2.1 AA.
Uso
/revisión-de-accesibilidad $ARGUMENTOS
Auditar accesibilidad: @$1
Referencia Rápida WCAG 2.1 AA
Perceptible
- 1.1.1 El contenido no textual tiene texto alternativo
- 1.3.1 La información y la estructura se transmiten semánticamente
- 1.4.3 Relación de contraste >= 4.5:1 (texto normal), >= 3:1 (texto grande)
- 1.4.11 Contraste de no texto >= 3:1 (componentes de UI, gráficos)
Operable
- 2.1.1 Toda la funcionalidad está disponible mediante teclado
- 2.4.3 Orden de enfoque lógico
- 2.4.7 Indicador de enfoque visible
- 2.5.5 Objetivo táctil >= 44x44 píxeles CSS
Comprensible
- 3.2.1 Predecible al enfocar (sin cambios inesperados)
- 3.3.1 Identificación de errores (describir el error)
- 3.3.2 Etiquetas o instrucciones para las entradas
Robusto
- 4.1.2 Nombre, rol y valor para todos los componentes de UI
Problemas Comunes
- Contraste de color insuficiente
- Etiquetas de formulario faltantes
- Sin acceso por teclado a elementos interactivos
- Falta de texto alternativo en imágenes significativas
- Atrapamientos de enfoque en modales
- Hitos ARIA faltantes
- Multimedia con reproducción automática sin controles
- Límites de tiempo sin opciones de extensión
Enfoque de Prueba
- Escaneo automatizado (detecta ~30% de los problemas)
- Navegación solo con teclado
- Prueba con lector de pantalla (VoiceOver, NVDA)
- Verificación de contraste de color
- Zoom al 200% — ¿se rompe el diseño?
Salida
## Auditoría de Accesibilidad: [Nombre del Diseño/Página]
**Estándar:** WCAG 2.1 AA | **Fecha:** [Fecha]
### Resumen
**Problemas encontrados:** [X] | **Críticos:** [X] | **Graves:** [X] | **Menores:** [X]
### Hallazgos
#### Perceptible
| # | Problema | Criterio WCAG | Gravedad | Recomendación |
|---|---------|---------------|----------|---------------|
| 1 | [Problema] | [1.4.3 Contraste] | 🔴 Crítico | [Solución] |
#### Operable
| # | Problema | Criterio WCAG | Gravedad | Recomendación |
|---|---------|---------------|----------|---------------|
| 1 | [Problema] | [2.1.1 Teclado] | 🟡 Grave | [Solución] |
#### Comprensible
| # | Problema | Criterio WCAG | Gravedad | Recomendación |
|---|---------|---------------|----------|---------------|
| 1 | [Problema] | [3.3.2 Etiquetas] | 🟢 Menor | [Solución] |
#### Robusto
| # | Problema | Criterio WCAG | Gravedad | Recomendación |
|---|---------|---------------|----------|---------------|
| 1 | [Problema] | [4.1.2 Nombre, Rol, Valor] | 🟡 Grave | [Solución] |
### Verificación de Contraste de Color
| Elemento | Primer Plano | Fondo | Relación | Requerido | ¿Cumple? |
|----------|-------------|-------|----------|-----------|----------|
| [Texto del cuerpo] | [color] | [color] | [X]:1 | 4.5:1 | ✅/❌ |
### Navegación por Teclado
| Elemento | Orden de Tabulación | Enter/Espacio | Escape | Flechas |
|----------|--------------------|---------------|--------|---------|
| [Elemento] | [Orden] | [Comportamiento] | [Comportamiento] | [Comportamiento] |
### Lector de Pantalla
| Elemento | Anunciado Como | Problema |
|----------|---------------|----------|
| [Elemento] | [Lo que dice el SR] | [Problema si lo hay] |
### Correcciones Prioritarias
1. **[Corrección crítica]** — Afecta a [quién] y bloquea [qué]
2. **[Corrección grave]** — Mejora [qué] para [quién]
3. **[Corrección menor]** — Agradable tenerlo
Si hay Conectores Disponibles
Si ~~herramienta de diseño está conectada:
- Inspeccionar valores de color, tamaños de fuente y objetivos táctiles directamente desde Figma
- Verificar roles ARIA de componentes y comportamiento del teclado en la especificación de diseño
Si ~~gestor de proyectos está conectado:
- Crear tickets para cada hallazgo de accesibilidad con gravedad y criterio WCAG
- Vincular hallazgos a epopeyas existentes de remediación de accesibilidad
Consejos
- Empieza con contraste y teclado — Estos detectan los problemas más comunes e impactantes.
- Prueba con tecnología de asistencia real — Mi auditoría es un buen comienzo, pero las pruebas manuales con VoiceOver/NVDA detectan cosas que yo no puedo.
- Prioriza por impacto — Arregla primero los problemas que bloquean a los usuarios, luego los de pulido.