Migration vers Axe DevTools pour Web v4.x pour Ruby

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

Étapes pour migrer vers la version 4.x d'Axe DevTools pour Web pour Ruby

Not for use with personal data

Axe DevTools pour Web Gems v4.x est une réécriture majeure de l'ensemble du projet. Les changements les plus notables sont résumés ci-dessous, suivis de modifications plus spécifiques pour les packages concernés.

Résumé

La suite de axe-devtools-* gems a été réarchitecturée pour alléger les outils d'intégration fournis et offrir une meilleure expérience développeur.

Comparé aux versions précédentes où une seule gem était fournie, cette version propose une collection de gems permettant aux utilisateurs finaux de choisir ce qui est essentiel et correspond le mieux à leur flux de travail actuel.

Étapes de migration

Étant donné le passage d'une structure gem monolithique à des gems individuels, certaines étapes de migration sont nécessaires. Vous pouvez utiliser le guide de migration suivant.

Configuration du développeur

Il n'y a aucun changement par rapport à la configuration développeur précédente. Les exigences nécessaires sont les suivantes :

Ruby (la dernière version)
Bundler pour les dépendances des gems
Rake comme gestionnaire de tâches
RSpec ou Cucumber pour les tests
Node et Npm pour installer le package axe-core

Installation de Axe DevTools pour Web Gems

Assurez-vous d'avoir accès à Deque's registry. Sinon, refer to the setup guide.

Après avoir accès au registre de Deque, vous pouvez installer l'un des gems suivants en les incluant dans le fichier Gemfile ou les fichiers gemspec.

gem "axe-devtools-cucumber"

Alternativement, vous pouvez spécifier une source pour le gem :

gem "attest-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'

Les gems disponibles sont :

Veuillez vous référer à la documentation pour les instructions d'utilisation et des informations détaillées sur les API.

Désinstallation des intégrations Ruby

Vous pouvez désinstaller les intégrations Ruby précédentes en exécutant les commandes ci-dessous :

gem uninstall axe-matchers
gem uninstall attest-ruby

Modifications Notables

D'autres modifications notables de l'intégration Ruby incluent :

La variable d'environnement pour configurer les règles personnalisées a été modifiée de ATTEST_PATH à AXE_RULESET_PATH. Référez-vous à advanced usage.
Le jeu de règles par défaut a changé. Axe DevTools pour Web audite une page donnée avec wcag2 comme jeu de règles par défaut. Aucun changement n'est requis par l'utilisateur final. Si vous souhaitez configurer un autre jeu de règles, vous pouvez utiliser les clauses respectives offertes dans la documentation Cucumber ou la documentation RSpec.
Les Matchers be_accessible dans RSpec ont été renommés en be_axe_clean.
La définition de l'étape be accessible dans RSpec a été renommée en be axe clean.