Utilizzare il set di regole RGAA con Axe DevTools per le API Web
Come funziona il set di regole RGAA, come si relaziona al WCAG e come selezionarlo da Axe DevTools per le API Web e CLI.
RGAA è uno degli standard di accessibilità contro i quali è possibile effettuare test con Axe DevTools per le API Web e CLI, identificato dall'ID del set di regole rgaav4. Questa pagina spiega cos'è il set di regole RGAA, come si relaziona ai set di regole WCAG quando si leggono i risultati e come selezionarlo in ogni binding linguistico e nella CLI. Per una panoramica di tutti gli standard disponibili, vedere Set di regole; per informazioni generali sul cambiamento del set di regole e della versione di axe-core, vedere Personalizzare le regole.
Cos'è RGAA?
RGAA, o Référentiel Général d'Amélioration de l'Accessibilité, è lo standard francese per l'accessibilità web. È ampiamente basato sul WCAG 2.1 e fornisce criteri tecnici specifici per valutare l'accessibilità dei contenuti web. La versione attualmente supportata è RGAA 4. Puoi anche trovare RGAA definito nel Glossario.
RGAA è principalmente rilevante per le organizzazioni che devono soddisfare gli obblighi francesi di accessibilità web, incluse le amministrazioni pubbliche e alcune grandi organizzazioni private operanti in Francia. È pubblicato e mantenuto dal governo francese sul sito ufficiale di RGAA.
Come RGAA si relaziona al WCAG
RGAA 4 non è un insieme di requisiti tecnici separati o più rigidi rispetto a WCAG. Trasporta i criteri di successo del livello A e AA di WCAG 2.1 in 106 criteri di controllo testabili organizzati in 13 aree tematiche, ciascuna con procedure di test dettagliate. Il livello tecnico sottostante è essenzialmente WCAG 2.1 AA, con RGAA che aggiunge una metodologia di audit prescrittiva francese, una formulazione in lingua francese e un regime di conformità legale.
Per chi legge risultati automatizzati, la differenza tra il set di regole RGAA e i set di regole WCAG è principalmente una questione di etichettatura e ambito piuttosto che di ciò che viene controllato. Axe-core implementa RGAA aggiungendo tag RGAA alle sue regole esistenti, che si basano in gran parte su WCAG, piuttosto che eseguendo un motore distinto. Selezionare il set di regole rgaav4 esegue le regole derivate da WCAG che mappano ai criteri RGAA, più un numero ridotto di regole che WCAG considera best practice ma che RGAA richiede — come ad esempio region, skip-link, table-duplicate-name, e l'esperimento focus-order-semantics.
Poiché RGAA richiede diverse regole che WCAG classifica come best practice ed esperimentali, una scansione RGAA rivela risultati che un'esecuzione predefinita di WCAG 2.1 AA non mostra. Aspettati che il set di regole rgaav4 segnali problemi che non vedresti con il set di regole predefinito wcag2.1.
Superare una scansione automatizzata RGAA non equivale a un pieno rispetto di RGAA: i test automatizzati coprono solo il sottoinsieme dei criteri di RGAA testabili automaticamente, e la piena conformità richiede inoltre test manuali, la metodologia di audit ufficiale, una dichiarazione di accessibilità e un tasso di conformità calcolato che sono al di fuori dell'ambito degli strumenti automatizzati.
Versione di axe-core
Il supporto per RGAA è un'aggiunta recente al motore di test di accessibilità, quindi il set di regole è disponibile solo quando la tua versione di axe-core è abbastanza aggiornata. Assicurarsi che la versione di axe-core sia coerente tra i componenti, gli sviluppatori e i team mantiene coerenti i risultati delle scansioni; vedere Personalizzare le regole per come viene selezionata la versione di axe-core.
RGAA 4 è supportato solo nelle versioni di axe-core 4.11.0 e successive.
Selezionare il set di regole RGAA
Per impostazione predefinita, Axe DevTools esegue i test secondo lo standard WCAG 2.1 AA. Selezioni RGAA nello stesso modo in cui selezioni qualsiasi altro set di regole, passando l'ID del set di regole rgaav4. Ogni binding linguistico espone il proprio metodo di selezione del set di regole; vedere Informazioni su Axe DevTools per le API Web per l'elenco completo delle lingue e dei framework supportati.
API
- Python (Panoramica di Python): seleziona il set di regole con
with_ruleset("rgaav4"). Vedi il Riferimento API di Python, o, per il Framework Robot, il Riferimento del Framework Robot. - Java (Panoramica di Java): seleziona il set di regole con
forRuleset("rgaav4"). Vedi il Riferimento API Selenium Java e il Guida per i test Selenium Java. Il Guida per i test Hamcrest Java non ha un metodoforRulesete seleziona invece RGAA come tag conaccordingTo("RGAAv4"). - C# (Panoramica di C#): seleziona il set di regole con
WithRuleset("rgaav4"). Vedi il Riferimento API di C#, che espone ancheRGAAv4come valoreTagTypeper la selezione basata su tag. - Node.js e JavaScript (Panoramica di Node.js e JavaScript): il meccanismo varia in base al framework. Passa l'ID del set di regole a
AxeDevTools.init("rgaav4")nel Riferimento di JavaScript per browser, usacy.setAxeRuleset("rgaav4")nel Documentazione API Cypress, o imposta l'opzione costruttorerulesetID: "rgaav4"nel Riferimento WebdriverIO. - Ruby (Introduzione a Ruby): RGAA è supportato nei pacchetti Ruby ed è selezionato tramite il meccanismo standard
according_to_rulesetdocumentato per RSpec e Cucumber. Nota che gli esempi di quelle pagine si concentrano sui set di regole WCAG e Sezione 508 e non enumerano esplicitamentergaav4.
La maggior parte di questi metodi accetta anche un argomento opzionale per abilitare le regole di best practice; il nome esatto varia per lingua, quindi consulta il riferimento collegato per ciascuna.
CLI
La CLI offre due modi per lavorare con RGAA. Innanzitutto, genera un file di configurazione standard RGAA v4 con axe ruleset --rgaav4, quindi applicalo quando esegui la scansione con il flag --custom. Vedi Regole personalizzate e il Riferimento CLI.
axe ruleset --rgaav4 # generates rgaav4.json
axe <url> --custom rgaav4.jsonIn secondo luogo, puoi registrare il set di regole nei metadati di --format universal emettendo --universal-ruleset rgaav4 (consulta le Riferimento CLI e le Test delle pagine), oppure imposta il parametro ruleset dell'azione analyze su rgaav4 in specifiche del flusso di lavoro.
RGAA nei Risultati e nei Tag
Quando esegui il set di regole RGAA, i risultati includono il tag del set di regole generale RGAAv4 insieme ai tag per criterio nella forma RGAA-x.x.x (ad esempio, RGAA-3.2.1). Questi tag compaiono accanto ai tag equivalenti di WCAG e di altri standard su ciascun risultato. Ad esempio, un riscontro color-contrast può includere i seguenti tag:
cat.color, wcag2aa, wcag143, TTv5, TT13.c, EN-301-549, EN-9.1.4.3, ACT, RGAAv4, RGAA-3.2.1Nota la distinzione tra i due identificatori: l'ID del set di regole che passi alle API e CLI è la stringa minuscola rgaav4, mentre la stringa del tag che appare nei risultati è la RGAAv4 maiuscola. Poiché axe-core copre solo il sottoinsieme testabile automaticamente dei criteri di RGAA, la presenza di tag RGAA sui tuoi risultati indica i controlli automatizzati che sono stati eseguiti, non la completa conformità RGAA.