Personalización de Axe DevTools para Reglas de Accesibilidad Web
Modificar la configuración de las reglas dentro de Axe DevTools para Web
Dentro de las APIs de Axe DevTools, existe la opción de cambiar tu conjunto de reglas estándar así como tu versión de axe-core. A medida que se actualiza Axe DevTools, el conjunto de reglas y la versión de axe-core cambiarán. Para los usuarios de solo una herramienta, la configuración específica del conjunto de reglas y la versión de axe-core puede no importarles. Para los usuarios de múltiples componentes de Axe DevTools, asegurarse de que todos utilicen la misma configuración de reglas y la misma versión de axe-core garantiza que los resultados de los escaneos sean 100% consistentes entre herramientas.
Configuración del Conjunto de Reglas
Axe DevTools tiene la capacidad de usar una amplia variedad de configuraciones de reglas. Para más información sobre los diversos conjuntos de reglas, lea la página sobre conjuntos de reglas de axe-core. Puedes cambiar a uno de varios otros conjuntos de reglas de WCAG, ADA sección 508, Trusted Tester v5, EN 301 549 o RGAA. Además, se pueden agregar modificaciones a estos conjuntos de reglas, como mejores prácticas no cubiertas por WCAG o sección 508, o reglas experimentales completamente nuevas a cualquier configuración de conjunto de reglas. Para una descripción de cada conjunto de reglas, consulte Conjuntos de reglas.
El conjunto de reglas predeterminado
A menos que configures algo diferente, Axe DevTools para Web APIs y la CLI prueban contra WCAG 2.1 Nivel AA, identificado por el ID del conjunto de reglas wcag2.1. Debido a que los conjuntos de reglas de WCAG son acumulativos, esto cubre las reglas de nivel A y nivel AA tanto de WCAG 2.0 como de WCAG 2.1.
Bajo el conjunto de reglas predeterminado, las reglas etiquetadas best-practice y las reglas etiquetadas experimental están desactivado. Un escaneo predeterminado solo informa fallas que se relacionan con los criterios de éxito del Nivel A y AA de WCAG 2.1, por lo que no muestra los hallazgos de mejores prácticas de Deque a menos que los solicites.
Las reglas de mejores prácticas no forman parte de ningún estándar de accesibilidad, pero ayudan a hacer que un sitio sea lo más equitativo posible en uso. Cómo las habilites depende del lenguaje, y no todas las integraciones exponen un interruptor dedicado:
| Lenguaje | Habilitar mejores prácticas |
|---|---|
| Java | Pasa true como el segundo argumento a forRuleset(rulesetId, enableBestPractices). Consulta el Referencia de API Java Selenium. |
| C# | Pasa true como el segundo argumento a WithRuleset(rulesetId, enableBestPractices). Consulta el Referencia de API de C#. |
| Python | Pasa enable_best_practices=True a with_ruleset(). Consulta el Referencia de API de Python. |
| Node.js y JavaScript | Playwright, Puppeteer y WebdriverIO aceptan una opción enableBestPractices. Otras integraciones seleccionan reglas por etiqueta en su lugar. Consulta el Resumen de Node.js y JavaScript. |
| Ruby | No hay indicador de mejores prácticas. Agrega la etiqueta best-practice a través de la cláusula de etiqueta descrita para RSpec y Cucumber. |
| CLI | Genera un archivo de conjunto de reglas que incluya las reglas de mejores prácticas y aplícalo con --custom. Consulta Conjuntos de reglas personalizados. |
Para probar con un estándar diferente, pasa su ID de conjunto de reglas en el mismo lugar. Usando el conjunto de reglas RGAA explica eso para un estándar y enumera el método de selección para cada lenguaje.
Versión de axe-core
El motor de pruebas de accesibilidad detrás de Axe DevTools, axe-core, se actualiza y mejora continuamente. Debido a esto, diferentes versiones de axe-core pueden no siempre producir los mismos resultados de escaneo. Asegurar que tu versión de axe-core sea consistente entre componentes, desarrolladores y equipos de desarrollo elimina los riesgos asociados con diferentes escaneos que producen resultados diferentes. En Axe DevTools, tu versión de axe-core se sincronizará con tu versión de Axe DevTools. Existe la opción de importar versiones específicas de axe-core.