Het RGAA-regelset gebruiken met Axe DevTools voor Web-API's

RGAA is een van de toegankelijkheidsstandaarden waarmee je kunt testen met de Axe DevTools voor Web-API's en CLI, geïdentificeerd door de regelset-ID rgaav4. Deze pagina legt uit wat het RGAA-regelset is, hoe het zich verhoudt tot de WCAG-regelsets wanneer je je resultaten bekijkt, en hoe je het selecteert in elke taalbinding en in de CLI. Voor een overzicht van alle beschikbare standaarden, zie Regelsets; voor algemene informatie over het wijzigen van je regelset en axe-core versie, zie Regels aanpassen.

Wat is RGAA?

RGAA, ofwel Référentiel Général d'Amélioration de l'Accessibilité, is de webtoegankelijkheidsstandaard van de Franse overheid. Het is grotendeels gebaseerd op WCAG 2.1 en biedt specifieke technische criteria voor de beoordeling van de toegankelijkheid van webinhoud. De momenteel ondersteunde versie is RGAA 4. Je kunt ook de definitie van RGAA vinden in de Woordenlijst.

RGAA is voornamelijk relevant voor organisaties die moeten voldoen aan de Franse webtoegankelijkheidsverplichtingen, waaronder overheidsinstanties en bepaalde grote particuliere organisaties die in Frankrijk opereren. Het wordt gepubliceerd en onderhouden door de Franse overheid op de officiële RGAA-site.

Hoe RGAA zich verhoudt tot WCAG

RGAA 4 is geen aparte of strengere set technische vereisten dan WCAG. Het transponeert de WCAG 2.1 level A en AA succescriteria in 106 testbare controlecriteria, georganiseerd in 13 thematische gebieden, elk met gedetailleerde testprocedures. De onderliggende technische norm is in wezen WCAG 2.1 AA, waarbij RGAA een voorschrijvende Franse auditmethodologie, Franstalige formuleringen en een wettelijk nalevingsregime toevoegt.

Voor iemand die geautomatiseerde resultaten leest, is het verschil tussen het RGAA-regelset en de WCAG-regelsets voornamelijk een kwestie van labeling en scope in plaats van wat er wordt gecontroleerd. Axe-core implementeert RGAA door RGAA-tags toe te voegen aan de bestaande, grotendeels op WCAG gebaseerde regels in plaats van een apart systeem te draaien. Selecteren van de rgaav4 regelset draait de van WCAG afgeleide regels die overeenkomen met RGAA-criteria, plus een klein aantal regels die WCAG als beste praktijk beschouwt maar door RGAA wordt vereist — zoals region, skip-link, table-duplicate-name, en de experimentele focus-order-semantics.

Axe-core versie

RGAA-ondersteuning is een recente toevoeging aan de toegankelijkheidstestmachine, dus de regelset is alleen beschikbaar wanneer je axe-core versie recent genoeg is. Het consistent houden van je axe-core versie over componenten, ontwikkelaars en teams zorgt voor consistente scanresultaten; zie Regels aanpassen voor hoe de axe-core versie wordt geselecteerd.

Het selecteren van het RGAA-regelset

Standaard test Axe DevTools volgens de WCAG 2.1 AA standaard. Je selecteert RGAA op dezelfde manier als elke andere regelset door de regelset-ID rgaav4 te geven. Elke taalbinding biedt zijn eigen methode voor het selecteren van een regelset; zie Over Axe DevTools voor Web-API's voor de volledige lijst van ondersteunde talen en frameworks.

API's

• Python (Python overzicht): selecteer de regelset met with_ruleset("rgaav4"). Zie de Python API-referentie, of, voor Robot Framework, de Robot Framework referentie.
• Java (Java overzicht): selecteer de regelset met forRuleset("rgaav4"). Zie de Java Selenium API-referentie en de Java Selenium testgids. De Java Hamcrest testgids heeft geen forRuleset methode en selecteert RGAA in plaats daarvan als een tag met accordingTo("RGAAv4").
• C# (C# overzicht): selecteer de regelset met WithRuleset("rgaav4"). Zie de C# API-referentie, die ook RGAAv4 blootstelt als een TagType waarde voor tag-gebaseerd selecteren.
• Node.js en JavaScript (Node.js en JavaScript overzicht): het mechanisme verschilt per framework. Geef de regelset-ID door aan AxeDevTools.init("rgaav4") in de Browser JavaScript-referentie, gebruik cy.setAxeRuleset("rgaav4") in de Cypress API-documentatie, of stel de rulesetID: "rgaav4" constructoroptie in de WebdriverIO-referentie in.
• Ruby (Ruby inleiding): RGAA wordt ondersteund in de Ruby-pakketten en wordt geselecteerd via het standaard according_to_ruleset mechanisme gedocumenteerd voor RSpec en Cucumber. Merk op dat de voorbeelden op die pagina's zich richten op de WCAG en Section 508 regelsets en niet expliciet rgaav4 opsommen.

De meeste van deze methoden accepteren ook een optioneel argument om beste-praktijkregels in te schakelen; de exacte naam varieert per taal, dus raadpleeg de gelinkte referentie voor elk ervan.

CLI

De CLI biedt twee manieren om met RGAA te werken. Ten eerste genereer je een standaard RGAA v4 configuratiebestand met axe ruleset --rgaav4, en pas je het vervolgens toe bij het scannen met de --custom-vlag. Zie Aangepaste regelsets en de CLI-referentie.

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

Ten tweede kun je de regelset opnemen in de metadata van --format universal uitvoer door --universal-ruleset rgaav4 door te geven (zie de CLI-referentie en Paginatests), of stel de ruleset parameter van de analyze actie in op rgaav4 in workflowspecificaties.

RGAA in Resultaten en Tags

Wanneer je de RGAA-regelset uitvoert, dragen resultaten de algemene regelset-tag RGAAv4 naast per-criterium tags in de vorm RGAA-x.x.x (bijvoorbeeld, RGAA-3.2.1). Deze tags verschijnen naast de equivalente WCAG en andere standaardtags bij elk resultaat. Bijvoorbeeld, een color-contrast bevinding kan de volgende tags bevatten:

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

Let op het onderscheid tussen de twee identificatoren: de regelset-ID die je doorgeeft aan de API's en CLI is de kleine letter string rgaav4, terwijl de tag string die verschijnt in resultaten de hoofdletter RGAAv4 is. Omdat axe-core alleen het machine-testbare deel van de RGAA-criteria dekt, geeft de aanwezigheid van RGAA-tags op je resultaten aan welke geautomatiseerde controles zijn uitgevoerd, niet de volledige RGAA-conformiteit.