Personalizzare Axe DevTools per le regole di accessibilità web
Modificare la configurazione delle regole all'interno di Axe DevTools per il Web
All'interno delle API di Axe DevTools, esiste l'opzione di modificare il tuo set di regole standard così come la versione di axe-core. Con l'aggiornamento di Axe DevTools, il set di regole e la versione di axe-core cambieranno. Per gli utenti di un solo strumento, la configurazione specifica del set di regole e la versione di axe-core potrebbero non essere rilevanti. Per gli utenti di più componenti di Axe DevTools, assicurarsi che tutti utilizzino la stessa configurazione di regole e la stessa versione di axe-core garantisce risultati di scansione 100% coerenti tra gli strumenti.
Configurazione del set di regole
Axe DevTools ha la capacità di utilizzare una vasta gamma di configurazioni di regole. Per ulteriori informazioni sui vari set di regole, leggi la pagina su set di regole axe-core. Puoi passare a uno dei diversi altri set di regole WCAG, ADA sezione 508, Trusted Tester v5, EN 301 549 o RGAA. Inoltre, modifiche a questi set di regole come migliori pratiche non coperte da WCAG o sezione 508, o nuovissime regole sperimentali possono essere aggiunte a qualsiasi configurazione di set di regole. Per una descrizione di ciascun set di regole, vedi Set di regole.
Il Set di Regole Predefinito
A meno che non configuri qualcosa di diverso, Axe DevTools per le API Web e la CLI eseguono test contro WCAG 2.1 Livello AA, identificato dall'ID del set di regole wcag2.1. Poiché i set di regole WCAG sono cumulativi, questo copre le regole del livello A e del livello AA sia di WCAG 2.0 che di WCAG 2.1.
Sotto il set di regole predefinito, le regole taggate best-practice e le regole taggate experimental sono impostate su spente. Una scansione predefinita riporta solo i fallimenti che corrispondono ai criteri di successo del WCAG 2.1 Livello A e AA, quindi non evidenzia i risultati delle migliori pratiche di Deque a meno che tu non li richieda.
Le regole delle migliori pratiche non fanno parte di alcuno standard di accessibilità, ma aiutano a rendere un sito il più equo possibile nell'uso. Come le attivi dipende dal linguaggio, e non tutte le integrazioni offrono un interruttore dedicato:
| Linguaggio | Abilitare le migliori pratiche |
|---|---|
| Java | Passa true come secondo argomento a forRuleset(rulesetId, enableBestPractices). Vedi il Riferimento API di Java Selenium. |
| C# | Passa true come secondo argomento a WithRuleset(rulesetId, enableBestPractices). Vedi il Riferimento API di C#. |
| Python | Passa enable_best_practices=True a with_ruleset(). Vedi il Riferimento API di Python. |
| Node.js e JavaScript | Playwright, Puppeteer e WebdriverIO accettano un'opzione enableBestPractices. Altre integrazioni selezionano le regole per tag invece. Vedi il Panoramica Node.js e JavaScript. |
| Ruby | Non esiste un flag per le migliori pratiche. Aggiungi il tag best-practice tramite la clausola dei tag descritta per RSpec e Cucumber. |
| CLI | Genera un file di set di regole che include le regole delle migliori pratiche e applicalo con --custom. Vedi Set di Regole Personalizzati. |
Per testare invece un altro standard, passa il suo ID del set di regole nello stesso luogo. Utilizzare il Set di Regole RGAA guida in questo per uno standard e elenca il metodo di selezione per ogni linguaggio.
Versione di axe-core
Il motore di test di accessibilità dietro Axe DevTools, axe-core, è continuamente aggiornato e migliorato. Per questo motivo, diverse versioni di axe-core potrebbero non produrre sempre gli stessi risultati di scansione. Garantire che la tua versione di axe-core sia coerente tra i componenti, gli sviluppatori e i team di sviluppo elimina i rischi associati a scansioni diverse che producono risultati diversi. In Axe DevTools, la tua versione di axe-core sarà sincronizzata con la tua versione di Axe DevTools. È disponibile l'opzione per importare versioni specifiche di axe-core.