Utilisation du jeu de règles RGAA avec Axe DevTools pour les API Web

RGAA est l'une des normes d'accessibilité que vous pouvez tester avec Axe DevTools pour les API Web et CLI, identifié par l'ID de jeu de règles rgaav4. Cette page explique ce qu'est le jeu de règles RGAA, comment il se rapporte aux jeux de règles WCAG lorsque vous lisez vos résultats, et comment le sélectionner dans chaque liaison linguistique et dans le CLI. Pour une vue d'ensemble de toutes les normes disponibles, voir Jeux de règles ; pour des informations générales sur la modification de votre jeu de règles et la version axe-core, voir Personnalisation des règles.

Qu'est-ce que RGAA ?

RGAA, ou Référentiel Général d'Amélioration de l'Accessibilité, est la norme d'accessibilité du web du gouvernement français. Elle est largement basée sur le WCAG 2.1 et fournit des critères techniques spécifiques pour évaluer l'accessibilité du contenu web. La version actuellement prise en charge est RGAA 4. Vous pouvez également trouver la définition de RGAA dans le Glossaire.

RGAA est principalement pertinent pour les organisations qui doivent répondre aux obligations françaises en matière d'accessibilité web, y compris les organismes du secteur public et certaines grandes organisations privées opérant en France. Il est publié et maintenu par le gouvernement français sur le site officiel RGAA.

Comment RGAA se rapporte-t-il au WCAG

RGAA 4 n'est pas un ensemble de exigences techniques distinct ou plus strict que le WCAG. Il transpose les critères de succès des niveaux A et AA de WCAG 2.1 en 106 critères de contrôle testables organisés en 13 domaines thématiques, chacun avec des procédures de test détaillées. Le niveau technique sous-jacent est essentiellement WCAG 2.1 AA, RGAA ajoutant une méthodologie d'audit prescriptive française, un libellé en français et un régime de conformité légale.

Pour quelqu'un qui lit les résultats automatisés, la différence entre le jeu de règles RGAA et les jeux de règles WCAG est principalement une question d'étiquetage et de périmètre plutôt que de vérification. Axe-core implémente RGAA en ajoutant des tags RGAA à ses règles existantes, largement basées sur WCAG, plutôt qu'en exécutant un moteur distinct. Sélectionner le jeu de règles rgaav4 exécute les règles dérivées de WCAG qui correspondent aux critères RGAA, plus un petit nombre de règles que WCAG considère comme meilleure pratique mais que RGAA exige — comme region, skip-link, table-duplicate-name et l'expérimental focus-order-semantics.

Version axe-core

Le support RGAA est une récente addition au moteur de test d'accessibilité, donc le jeu de règles n'est disponible que lorsque votre version de axe-core est suffisamment à jour. Assurer que votre version de axe-core est cohérente à travers les composants, développeurs et équipes maintient la cohérence des résultats de scan ; voir Personnalisation des règles pour savoir comment la version axe-core est sélectionnée.

Sélection du jeu de règles RGAA

Par défaut, Axe DevTools teste selon la norme WCAG 2.1 AA. Vous sélectionnez RGAA de la même manière que vous sélectionnez tout autre jeu de règles, en passant l'ID de jeu de règles rgaav4. Chaque liaison linguistique expose sa propre méthode de sélection de jeu de règles ; voir À propos des Axe DevTools pour les API Web pour la liste complète des langues et frameworks pris en charge.

API

• Python (Vue d'ensemble de Python) : sélectionnez le jeu de règles avec with_ruleset("rgaav4"). Voir le Référence API Python, ou, pour Robot Framework, le Référence Robot Framework.
• Java (Vue d'ensemble de Java) : sélectionnez le jeu de règles avec forRuleset("rgaav4"). Voir le Référence API Java Selenium et le Guide de test Java Selenium. Le Guide de test Java Hamcrest n'a pas de méthode forRuleset et sélectionne plutôt RGAA comme tag avec accordingTo("RGAAv4").
• C# (Vue d'ensemble de C#) : sélectionnez le jeu de règles avec WithRuleset("rgaav4"). Voir le Référence API C#, qui expose également RGAAv4 comme valeur TagType pour la sélection basée sur les tags.
• Node.js et JavaScript (Vue d'ensemble de Node.js et JavaScript) : le mécanisme diffère selon le framework. Passez l'ID de jeu de règles à AxeDevTools.init("rgaav4") dans le Référence JavaScript pour le navigateur, utilisez cy.setAxeRuleset("rgaav4") dans le Documentation de l'API Cypress, ou définissez l'option de constructeur rulesetID: "rgaav4" dans le Référence WebdriverIO.
• Ruby (Introduction à Ruby) : RGAA est pris en charge dans les packages Ruby et est sélectionné via le mécanisme standard according_to_ruleset documenté pour RSpec et Cucumber. Notez que les exemples de ces pages se concentrent sur les jeux de règles WCAG et Section 508 et n'énumèrent pas explicitement rgaav4.

La plupart de ces méthodes acceptent également un argument optionnel pour activer les règles de meilleures pratiques ; le nom exact varie selon la langue, donc consultez la référence liée pour chacune.

CLI

Le CLI offre deux façons de travailler avec RGAA. Tout d'abord, générez un fichier de configuration standard RGAA v4 avec axe ruleset --rgaav4, puis appliquez-le lors de l'analyse avec le drapeau --custom. Voir Règles personnalisées et le Référence CLI.

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

Deuxièmement, vous pouvez enregistrer le jeu de règles dans les métadonnées de --format universal généré en passant --universal-ruleset rgaav4 (voir les Référence CLI et Tests de page), ou définir le paramètre ruleset de l'action analyze sur rgaav4 dans spécifications du workflow.

RGAA dans les résultats et tags

Lorsque vous exécutez le jeu de règles RGAA, les résultats portent le tag du jeu de règles global RGAAv4 ainsi que des tags par critère sous la forme RGAA-x.x.x (par exemple, RGAA-3.2.1). Ces tags apparaissent à côté des tags équivalents WCAG et autres normes sur chaque résultat. Par exemple, une découverte color-contrast peut inclure les tags suivants :

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

Notez la distinction entre les deux identifiants : l'ID du jeu de règles que vous passez aux API et CLI est la chaîne en minuscules rgaav4, tandis que la chaîne de tags qui apparaît dans les résultats est RGAAv4 avec majuscules. Parce qu'axe-core ne couvre que le sous-ensemble des critères de RGAA testables par machine, la présence de tags RGAA sur vos résultats indique les vérifications automatisées qui ont été effectuées, et non la conformité complète au RGAA.