Verwendung des RGAA-Regelwerks mit Axe DevTools für 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

Wie das RGAA-Regelwerk funktioniert, wie es sich auf WCAG bezieht und wie man es aus den Axe DevTools für Web-APIs und CLI auswählt.

Not for use with personal data

RGAA ist eines der Barrierefreiheitsstandards, gegen die Sie mit den Axe DevTools für Web-APIs und CLI testen können, identifiziert durch die Regelwerks-ID rgaav4. Diese Seite erklärt, was das RGAA-Regelwerk ist, wie es sich auf die WCAG-Regelwerke bezieht, wenn Sie Ihre Ergebnisse lesen, und wie Sie es in jeder Sprachbindung und im CLI auswählen. Für eine Übersicht über alle verfügbaren Standards siehe Regelwerke; für allgemeine Informationen zur Änderung Ihres Regelwerks und der axe-core-Version siehe Anpassen von Regeln.

Was ist RGAA?

RGAA, oder Référentiel Général d'Amélioration de l'Accessibilité, ist der Web-Barrierefreiheitsstandard der französischen Regierung. Er basiert größtenteils auf WCAG 2.1 und bietet spezifische technische Kriterien zur Bewertung der Zugänglichkeit von Webinhalten. Die aktuell unterstützte Version ist RGAA 4. Sie können RGAA auch im Glossar finden.

RGAA ist hauptsächlich für Organisationen relevant, die den französischen Barrierefreiheitsvorgaben im Web entsprechen müssen, einschließlich öffentlicher Stellen und bestimmter großer privater Organisationen, die in Frankreich tätig sind. Es wird von der französischen Regierung auf der offizielle RGAA-Website veröffentlicht und gepflegt.

Wie RGAA sich auf WCAG bezieht

RGAA 4 ist kein separates oder strengeres Set technischer Anforderungen als WCAG. Es überträgt die Erfolgskriterien WCAG 2.1 Level A und AA in 106 testbare Kontrollkriterien, die in 13 thematische Bereiche gegliedert sind, jeweils mit detaillierten Testverfahren. Der zugrundeliegende technische Standard ist im Wesentlichen WCAG 2.1 AA, wobei RGAA eine vorschreibende französische Audit-Methodik, französischsprachige Formulierungen und ein rechtliches Compliance-Regime hinzufügt.

Für jemanden, der automatisierte Ergebnisse liest, besteht der Unterschied zwischen dem RGAA-Regelwerk und den WCAG-Regelwerken hauptsächlich in der Kennzeichnung und im Umfang, nicht darin, was überprüft wird. Axe-core implementiert RGAA, indem es RGAA-Tags zu seinen bestehenden, größtenteils WCAG-basierten Regeln hinzufügt, anstatt ein eigenständiges System laufen zu lassen. Durch das Auswählen des rgaav4 Regelwerks werden die WCAG-abgeleiteten Regeln ausgeführt, die den RGAA-Kriterien entsprechen, plus einer kleinen Anzahl von Regeln, die WCAG als Best Practice behandelt, aber RGAA erfordert — wie region, skip-link, table-duplicate-name und das experimentelle focus-order-semantics.

important

Da RGAA mehrere Regeln erfordert, die WCAG als Best Practice und experimentell einstuft, bringt ein RGAA-Scan Erkenntnisse zutage, die ein standardmäßiger WCAG 2.1 AA-Scan nicht hat. Erwarten Sie, dass das rgaav4 Regelwerk Probleme meldet, die Sie unter dem Standard-wcag2.1-Regelwerk nicht sehen würden.

note

Das Bestehen eines automatisierten RGAA-Scans ist nicht dasselbe wie die vollständige RGAA-Konformität: Automatisierte Tests decken nur den maschinentestbaren Teil der RGAA-Kriterien ab, und volle Konformität erfordert zusätzlich manuelle Tests, die offizielle Audit-Methodik, eine Zugänglichkeitserklärung und eine berechnete Konformitätsrate, die außerhalb des Anwendungsbereichs automatisierter Tools liegen.

axe-core Version

Die Unterstützung von RGAA ist eine neue Ergänzung der Barrierefreiheits-Test-Engine, daher ist das Regelwerk nur verfügbar, wenn Ihre axe-core-Version aktuell genug ist. Die Sicherstellung, dass Ihre axe-core-Version über Komponenten, Entwickler und Teams hinweg konsistent ist, hält die Scan-Ergebnisse konsistent; siehe Anpassen von Regeln, um zu erfahren, wie die axe-core-Version ausgewählt wird.

important

RGAA 4 wird nur in axe-core-Versionen 4.11.0 und höher unterstützt.

Auswahl des RGAA-Regelwerks

Standardmäßig testen die Axe DevTools gemäß dem WCAG 2.1 AA-Standard. Sie wählen RGAA genauso aus wie jedes andere Regelwerk, indem Sie die Regelwerks-ID rgaav4 übergeben. Jede Sprachbindung bietet ihre eigene Methode zur Auswahl des Regelwerks; siehe Über Axe DevTools für Web-APIs für die vollständige Liste der unterstützten Sprachen und Frameworks.

APIs

Python (Python-Übersicht): wählen Sie das Regelwerk mit with_ruleset("rgaav4") aus. Siehe die Python API-Referenz, oder für Robot Framework die Robot Framework-Referenz.
Java (Java-Übersicht): wählen Sie das Regelwerk mit forRuleset("rgaav4") aus. Siehe die Java Selenium API-Referenz und die Java Selenium-Testanleitung. Der Java Hamcrest-Testanleitung hat keine forRuleset Methode und wählt stattdessen RGAA als Tag mit accordingTo("RGAAv4") aus.
C# (C#-Übersicht): wählen Sie das Regelwerk mit WithRuleset("rgaav4") aus. Siehe die C# API-Referenz, die auch RGAAv4 als TagType Wert zur tagbasierten Auswahl offenlegt.
Node.js und JavaScript (Node.js und JavaScript-Übersicht): der Mechanismus unterscheidet sich je nach Framework. Übergeben Sie die Regelwerks-ID an AxeDevTools.init("rgaav4") im Browser-JavaScript-Referenz, verwenden Sie cy.setAxeRuleset("rgaav4") im Cypress API-Dokumentation oder stellen Sie die rulesetID: "rgaav4" Konstruktoroption im WebdriverIO-Referenz ein.
Ruby (Ruby-Einführung): RGAA wird in den Ruby-Paketen unterstützt und wird über den Standard-according_to_ruleset-Mechanismus ausgewählt, der für RSpec und Cucumber dokumentiert ist. Beachten Sie, dass sich die Beispiele auf diesen Seiten auf die WCAG- und Section 508-Regelwerke konzentrieren und rgaav4 nicht explizit auflisten.

Die meisten dieser Methoden akzeptieren auch ein optionales Argument zur Aktivierung von Best-Practice-Regeln; der genaue Name variiert je nach Sprache, daher konsultieren Sie bitte die verlinkte Referenz für jede.

CLI

Die CLI bietet zwei Möglichkeiten zur Arbeit mit RGAA. Erstens erstellen Sie eine Standard-RGAA-v4-Konfigurationsdatei mit axe ruleset --rgaav4 und wenden diese dann beim Scannen mit dem --custom-Flag an. Siehe Benutzerdefinierte Regelsätze und die CLI-Referenz.

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

Zweitens können Sie den Regelsatz in den Metadaten von --format universal-Ausgaben speichern, indem Sie --universal-ruleset rgaav4 übergeben (siehe CLI-Referenz und Seitentests), oder den ruleset-Parameter der analyze-Aktion in rgaav4 auf Ablaufspezifikationen setzen.

RGAA in Ergebnissen und Tags

Wenn Sie den RGAA-Regelsatz ausführen, tragen die Ergebnisse das übergeordnete Regelsatz-Tag RGAAv4 zusammen mit Tags pro Kriterium in der Form RGAA-x.x.x (zum Beispiel RGAA-3.2.1). Diese Tags erscheinen neben den entsprechenden WCAG- und anderen Standard-Tags bei jedem Ergebnis. Beispielsweise kann ein color-contrast-Befund folgende Tags enthalten:

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

Beachten Sie den Unterschied zwischen den beiden Kennungen: Die Regelsatz-ID, die Sie an die APIs und CLI übergeben, ist der Kleinbuchstaben-String rgaav4, während der Zeichenfolgen-Tag, der in den Ergebnissen erscheint, der Großbuchstaben-RGAAv4 ist. Da axe-core nur den maschinentestbaren Teil von RGAAs Kriterien abdeckt, zeigt das Vorhandensein von RGAA-Tags in Ihren Ergebnissen an, welche automatisierten Prüfungen durchgeführt wurden, jedoch nicht die vollständige RGAA-Konformität.