Usar el conjunto de reglas RGAA con Axe DevTools para Web APIs

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Cómo funciona el conjunto de reglas RGAA, cómo se relaciona con WCAG, y cómo seleccionarlo en Axe DevTools para Web APIs y CLI.

Not for use with personal data

RGAA es uno de los estándares de accesibilidad que puedes evaluar con Axe DevTools para Web APIs y CLI, identificado por el ID del conjunto de reglas rgaav4. Esta página explica qué es el conjunto de reglas RGAA, cómo se relaciona con los conjuntos de reglas WCAG cuando lees tus resultados, y cómo seleccionarlo en cada enlace de lenguaje y en el CLI. Para obtener una visión general de todos los estándares disponibles, consulta Conjuntos de reglas; para información general sobre cómo cambiar tu conjunto de reglas y versión de axe-core, consulta Personalizar reglas.

¿Qué es RGAA?

RGAA, o Référentiel Général d'Amélioration de l'Accessibilité, es el estándar de accesibilidad web del gobierno francés. Está basado en gran medida en WCAG 2.1 y proporciona criterios técnicos específicos para evaluar la accesibilidad del contenido web. La versión actualmente soportada es RGAA 4. También puedes encontrar RGAA definido en el Glosario.

RGAA es principalmente relevante para organizaciones que deben cumplir con las obligaciones de accesibilidad web en Francia, incluidas las entidades del sector público y ciertas grandes organizaciones privadas que operan en Francia. Es publicado y mantenido por el gobierno francés en el sitio oficial de RGAA.

Cómo se relaciona RGAA con WCAG

RGAA 4 no es un conjunto separado o más estricto de requisitos técnicos que WCAG. Transpone los criterios de éxito de nivel A y AA de WCAG 2.1 en 106 criterios de control testables organizados en 13 áreas temáticas, cada una con procedimientos de prueba detallados. El nivel técnico subyacente es esencialmente WCAG 2.1 AA, y RGAA añade una metodología de auditoría francesa prescriptiva, redacción en idioma francés y un régimen de cumplimiento legal.

Para alguien que lee resultados automatizados, la diferencia entre el conjunto de reglas RGAA y los conjuntos de reglas WCAG es principalmente una cuestión de etiquetado y alcance, más que de lo que se verifica. Axe-core implementa RGAA añadiendo etiquetas RGAA a sus reglas existentes, en gran medida basadas en WCAG, en lugar de ejecutar un motor distinto. Seleccionar el conjunto de reglas rgaav4 ejecuta las reglas derivadas de WCAG que se corresponden con los criterios de RGAA, además de un pequeño número de reglas que WCAG trata como mejores prácticas pero que RGAA requiere, como region, skip-link, table-duplicate-name, y el experimental focus-order-semantics.

important

Debido a que RGAA requiere varias reglas que WCAG clasifica como mejores prácticas y experimentales, un análisis RGAA revela hallazgos que una ejecución por defecto de WCAG 2.1 AA no detecta. Espera que el conjunto de reglas rgaav4 informe problemas que no verías bajo el conjunto de reglas por defecto wcag2.1.

note

Superar una prueba automatizada de RGAA no es lo mismo que cumplir completamente con RGAA: las pruebas automatizadas cubren solo el subconjunto de criterios de RGAA que se pueden evaluar con máquinas, y la conformidad total requiere adicionalmente pruebas manuales, la metodología de auditoría oficial, una declaración de accesibilidad, y una tasa de conformidad calculada que están fuera del alcance de las herramientas automatizadas.

Versión de axe-core

El soporte para RGAA es una adición reciente al motor de pruebas de accesibilidad, por lo que el conjunto de reglas solo está disponible cuando tu versión de axe-core es lo suficientemente actual. Asegurarte de que tu versión de axe-core sea coherente en todos los componentes, desarrolladores y equipos mantiene los resultados de las pruebas consistentes; consulta Personalizar reglas para saber cómo se selecciona la versión de axe-core.

important

RGAA 4 solo es compatible con versiones de axe-core 4.11.0 y superiores.

Seleccionar el conjunto de reglas RGAA

Por defecto, Axe DevTools prueba según el estándar WCAG 2.1 AA. Seleccionas RGAA de la misma manera que cualquier otro conjunto de reglas, pasando el ID del conjunto de reglas rgaav4. Cada enlace de lenguaje expone su propio método de selección de conjuntos de reglas; consulta Sobre Axe DevTools para Web APIs para ver la lista completa de lenguajes y frameworks compatibles.

APIs

Python (Resumen de Python): selecciona el conjunto de reglas con with_ruleset("rgaav4"). Consulta el Referencia de API de Python, o, para Robot Framework, la Referencia de Robot Framework.
Java (Resumen de Java): selecciona el conjunto de reglas con forRuleset("rgaav4"). Consulta el Referencia de API de Selenium en Java y el Guía de pruebas de Selenium en Java. El Guía de pruebas de Hamcrest en Java no tiene método forRuleset y en su lugar selecciona RGAA como una etiqueta con accordingTo("RGAAv4").
C# (Resumen de C#): selecciona el conjunto de reglas con WithRuleset("rgaav4"). Consulta el Referencia de API de C#, que también expone RGAAv4 como un valor TagType para la selección basada en etiquetas.
Node.js y JavaScript (Resumen de Node.js y JavaScript): el mecanismo varía según el framework. Pasa el ID del conjunto de reglas a AxeDevTools.init("rgaav4") en el Referencia de JavaScript para navegador, usa cy.setAxeRuleset("rgaav4") en el Documentación de API de Cypress, o establece la opción del constructor rulesetID: "rgaav4" en el Referencia de WebdriverIO.
Ruby (Introducción a Ruby): RGAA está soportado en los paquetes de Ruby y se selecciona a través del mecanismo estándar according_to_ruleset documentado para RSpec y Cucumber. Ten en cuenta que los ejemplos de esas páginas se centran en los conjuntos de reglas de WCAG y la Sección 508 y no enumeran rgaav4 explícitamente.

La mayoría de estos métodos también aceptan un argumento opcional para habilitar reglas de mejores prácticas; el nombre exacto varía según el lenguaje, por lo que consulta la referencia enlazada para cada uno.

CLI

La CLI ofrece dos maneras de trabajar con RGAA. Primero, genera un archivo de configuración estándar de RGAA v4 con axe ruleset --rgaav4, luego aplícalo al escanear con la bandera --custom. Consulta Conjuntos de reglas personalizadas y el Referencia de la CLI.

axe ruleset --rgaav4          # generates rgaav4.json
axe <url> --custom rgaav4.json

En segundo lugar, puedes registrar el conjunto de reglas en los metadatos de --format universal producido pasando --universal-ruleset rgaav4 (consulta Referencia de la CLI y Pruebas de página), o establecer el parámetro ruleset de la acción analyze a rgaav4 en especificaciones del flujo de trabajo.

RGAA en Resultados y Etiquetas

Cuando ejecutas el conjunto de reglas RGAA, los resultados llevan la etiqueta general del conjunto de reglas RGAAv4 junto con etiquetas por criterio en la forma RGAA-x.x.x (por ejemplo, RGAA-3.2.1). Estas etiquetas aparecen junto a las etiquetas equivalentes de WCAG y otros estándares en cada resultado. Por ejemplo, un hallazgo de color-contrast puede incluir las siguientes etiquetas:

cat.color, wcag2aa, wcag143, TTv5, TT13.c, EN-301-549, EN-9.1.4.3, ACT, RGAAv4, RGAA-3.2.1

Observa la distinción entre los dos identificadores: el ID del conjunto de reglas que pasas a las API y CLI es el string en minúsculas rgaav4, mientras que el string de la etiqueta que aparece en los resultados es el capitalizado RGAAv4. Debido a que axe-core cubre solo el subconjunto verificable por máquina de los criterios de RGAA, la presencia de etiquetas RGAA en tus resultados indica los controles automáticos que se ejecutaron, no el cumplimiento total de RGAA.