| name | kdd-wcag |
| description | Verifica HTML contra 10 criterios de exito de WCAG 2.2: idioma declarado, contraste minimo, area de toque, etiquetas, autocomplete, alternativa a movimiento, control de autoplay, saltar bloques, y nombre/rol de componentes. Usala cuando el usuario pida revisar, auditar o confirmar accesibilidad de una pagina HTML. |
KDD WCAG 2.2 Checker
Extraido de los 104 criterios de WCAG 2.2 con el método
Knowledge-Driven Development (kdd-book). Los criterios
de WCAG se llaman literalmente "testable success criteria" — están operacionalizados al máximo por
diseño, con umbrales numéricos explícitos (contraste 4.5:1, área de toque 24×24px). Aun así, solo 10
de los 104 (11,5%) terminan siendo instrumentables con este método: el resto pide juicio humano sobre
contenido (¿el texto alternativo describe bien la imagen?) que ningún regex puede confirmar.
Verde en este skill significa "estos 10 mecanismos están", no "la página es accesible". Quedan
94 criterios reales de WCAG fuera de esta pila A, y decirlo es parte del método.
Flujo
-
Encontrá el HTML relevante: la página o el componente que el usuario quiera auditar.
-
Corré los chequeos relevantes:
python scripts/a11y_checks.py --rule idioma <pagina.html>
python scripts/a11y_checks.py --rule contraste --min 4.5 <pagina.html>
python scripts/a11y_checks.py --rule toque --min 24 <pagina.html>
python scripts/a11y_checks.py --rule etiqueta <pagina.html>
python scripts/a11y_checks.py --rule autocomplete <pagina.html>
python scripts/a11y_checks.py --rule movimiento <pagina.html>
python scripts/a11y_checks.py --rule autoplay <pagina.html>
python scripts/a11y_checks.py --rule saltar <pagina.html>
python scripts/a11y_checks.py --rule nombrerol <pagina.html>
python scripts/a11y_checks.py --rule etiquetaennombre <pagina.html>
contraste y toque comparten --min: dos criterios de conformidad distintos usan el mismo
mecanismo con un umbral diferente. Exit 0 (cumple), 1 (no cumple, con detalle) o 2 (no se
pudo verificar — por ejemplo, --min faltante o con el valor equivocado).
-
Reportá cada regla corrida con [PASSED] / [FAILED] / [NO VERIFICABLE].
-
Para el resto de WCAG 2.2 (94 criterios restantes), consultá scripts/knowledge.json. Cada
nodo trae pile (A=medible, B=juicio real sin umbral, C=conocimiento), title,
description y, si es B, un why_not. No inventes un umbral para un criterio que el nodo
dice que requiere juicio humano sobre contenido.
Límite declarado, sin excepciones
html_checks construye su propio árbol a partir de html.parser (no un DOM completo). El nombre
accesible que compara etiquetaennombre es el texto visible del elemento, no el cálculo completo del
algoritmo de "Accessible Name and Description Computation" del W3C -una aproximación declarada, no el
algoritmo entero-.
Reporte
| Regla | Estado | Archivo:línea | Detalle |
|---|
| (una fila por cada regla corrida) | [PASSED]/[FAILED]/[NO VERIFICABLE] | ... | ... |
Recursos incluidos
scripts/a11y_checks.py + scripts/html_checks.py (dependencia: a11y_checks reusa el árbol de
html_checks en vez de construir otro) — extraídos y verificados (sabotaje de cada regla, atajos
prohibidos reconstruidos a mano) en kdd-book.scripts/knowledge.json — los 104 criterios de WCAG 2.2, triados en pila A/B/C con su why_not
cuando corresponde.
