Personnaliser Axe DevTools pour les règles d'accessibilité Web
Modifier la configuration des règles dans Axe DevTools pour le Web
Au sein des API Axe DevTools, il est possible de modifier votre ensemble de règles standard ainsi que votre version d'axe-core. À mesure que Axe DevTools est mis à jour, l'ensemble de règles et la version d'axe-core changeront. Pour les utilisateurs d'un seul outil, la configuration spécifique de l'ensemble de règles et la version d'axe-core peuvent ne pas importer. Pour les utilisateurs de plusieurs composants Axe DevTools, s'assurer qu'ils utilisent tous la même configuration de règles et la même version d'axe-core garantit des résultats d'analyse 100 % cohérents entre les outils.
Configuration de l'ensemble de règles
Axe DevTools a la capacité d'utiliser une large variété de configurations de règles. Pour plus d'informations sur les différents ensembles de règles, lisez la page sur les ensembles de règles axe-core. Vous pouvez passer à l'un des nombreux autres ensembles de règles WCAG, ADA section 508, Trusted Tester v5, EN 301 549 ou RGAA. De plus, des modifications à ces ensembles de règles, telles que les meilleures pratiques non couvertes par les WCAG ou la section 508, ou des règles expérimentales toutes nouvelles, peuvent être ajoutées à toute configuration d'ensemble de règles. Pour une description de chaque ensemble de règles, voir Ensembles de règles.
L'ensemble de règles par défaut
À moins que vous ne configuriez autre chose, les Axe DevTools pour les API Web et le CLI testent par rapport à WCAG 2.1 Niveau AA, identifié par l'ID de l'ensemble de règles wcag2.1. Étant donné que les ensembles de règles WCAG sont cumulatifs, cela couvre les règles de niveau A et de niveau AA de WCAG 2.0 et WCAG 2.1.
Sous l'ensemble de règles par défaut, les règles marquées best-practice et les règles marquées experimental sont mises désactivé. Une analyse par défaut ne rapporte que les échecs qui correspondent aux critères de succès WCAG 2.1 de niveau A et AA, de sorte qu'elle ne fait pas apparaître les constats de meilleures pratiques de Deque à moins que vous ne les demandiez.
Les règles de meilleures pratiques ne font partie d'aucune norme d'accessibilité, mais elles aident à rendre un site aussi équitable à l'utilisation que possible. La façon de les activer dépend du langage, et toutes les intégrations n'exposent pas un commutateur dédié :
| Langage | Activation des meilleures pratiques |
|---|---|
| Java | Passez true comme deuxième argument à forRuleset(rulesetId, enableBestPractices). Voir la Référence de l'API Java Selenium. |
| C# | Passez true comme deuxième argument à WithRuleset(rulesetId, enableBestPractices). Voir la Référence de l'API C#. |
| Python | Passez enable_best_practices=True à with_ruleset(). Voir la Référence de l'API Python. |
| Node.js et JavaScript | Playwright, Puppeteer et WebdriverIO acceptent une option enableBestPractices. D'autres intégrations sélectionnent les règles par tag à la place. Voir la Aperçu de Node.js et JavaScript. |
| Ruby | Il n'y a pas de drapeau pour les meilleures pratiques. Ajoutez le tag best-practice via la clause de tag décrite pour RSpec et Cucumber. |
| CLI | Générez un fichier de règles qui inclut les règles de meilleures pratiques et appliquez-le avec --custom. Voir Ensembles de règles personnalisés. |
Pour tester avec une autre norme, passez son ID d'ensemble de règles au même endroit. Utiliser l'ensemble de règles RGAA vous guide pour une norme et répertorie la méthode de sélection pour chaque langage.
Version d'axe-core
Le moteur de test d'accessibilité derrière Axe DevTools, axe-core, est continuellement mis à jour et amélioré. En raison de cela, différentes versions d'axe-core peuvent ne pas toujours produire les mêmes résultats d'analyse. Assurer que votre version d'axe-core est cohérente entre les composants, les développeurs, et les équipes de développement élimine les risques liés à différentes analyses produisant des résultats différents. Dans Axe DevTools, votre version d'axe-core sera synchronisée avec votre version d'Axe DevTools. L'option est disponible pour importer des versions spécifiques d'axe-core.