Utilisation de règles personnalisées

Présentation des règles personnalisées dans l'extension axe Expert

Lorsque vous souhaitez que l'outil axe Expert analyse les pages Web et les applications par rapport à des règles spécifiques aux besoins uniques de votre organisation, il est possible de le faire avec la fonctionnalité Règles personnalisées du Rules panneau. Cliquer sur l'élément de lien Règles dans le menu principal d'Axe Expert (menu déroulant près du logo d'extension Axe Expert en haut du volet de gauche) entraîne l'apparition d'un panneau proposant un bouton Ajouter un jeu de règles personnalisé pour afficher un formulaire dans le volet de droite afin de soumettre un ensemble de règles personnalisées. Rules Le formulaire simple se compose de deux champs de saisie de texte et d'un bouton d'action qui vous permettent de configurer des règles personnalisées qui peuvent être sélectionnées pour être exécutées dans le moteur automatisé lorsqu'une page chargée est analysée sur le panneau Analyser.

Tout comme l'analyse d'une page avec les ensembles de règles Axe Expert, les résultats afficheront toutes les violations de vos règles personnalisées détectées, ainsi que les informations que vous avez spécifiées dans l'ensemble de règles personnalisées (cible, source HTML, Résumé de la remédiation, lien d'aide Plus d'informations, etc.). Toutes les autres options d’action disponibles avec les règles standard s’appliquent également à vos violations de règles personnalisées (Inspecter, Mettre en surbrillance, Exporter, Télécharger, etc.). Il existe une limite de cinq jeux de règles personnalisés autorisés à la fois.

1. Ajouter un bouton d'ensemble de règles : dans la Custom rulesets section du volet gauche du Rules panneau, une +Add a ruleset commande vous présente un formulaire dans le volet droit pour soumettre un ensemble de règles personnalisé.
2. Nom des règles personnalisées (alphanumérique uniquement) : il s'agira du nom du jeu de règles qui apparaîtra dans la section Normes de l'onglet Paramètres. Il est important de respecter les conventions (alphanumérique, pas d'espaces) et de s'assurer que le nom sera significatif et facilement reconnaissable comme option de sélection.
3. Entrez JSON rules.textareaInstructions : JavaScript Object Notation (JSON) est la norme textuelle à laquelle le contenu doit se conformer pour fonctionner avec l'extension de navigateur HTML 2.0 de Firefox. Pour plus d'informations, voir Exemple ci-dessous.
4. Bouton ENREGISTRER ET UTILISER LE JEU DE RÈGLES  : fait en sorte que les règles personnalisées deviennent une option sélectionnable dans le menu du volet latéral gauche du panneau Rules . Pour plus d'informations, voir Sélectionner un ensemble de règles.

Exemple de règle personnalisée

L'exemple de code qui suit peut servir d'exemple fonctionnel d'un fichier JSON de règle personnalisée axe Expert correctement formaté.

{
  "checks": [
    {
      "id": "test",
      "options": ["test"],
      "evaluate": "function() { return false; }",
      "metadata": {
        "impact": "minor",
        "messages": {
          "pass": "how did you pass",
          "fail": "there is no way to pass"
        }
      }
    }
  ],
  "rules": [
    {
      "id": "test",
      "metadata": {
        "description": "Will always fail",
        "help": "There is no way to make this pass! It is for testing",
        "helpUrl": "https://foo.com/bar"
      },
      "selector": "html",
      "any": [],
      "all": ["test"],
      "none": [],
      "tags": ["wcag2aa"]
    }
  ]
}

Ensembles de règles personnalisés à partir des projets axe Monitor : après vous être connecté à axe Monitor et avoir sélectionné un projet, tous les ensembles de règles personnalisés associés à ce projet sont automatiquement chargés dans le panneau et rendus disponibles pour la sélection. Rules

Soumettre des règles personnalisées

Lorsque vous souhaitez soumettre des règles personnalisées pour une utilisation future dans l'extension axe Expert, suivez ces étapes simples. La soumission de règles personnalisées s'effectue en spécifiant un nom pour le jeu de règles à des fins de sélection future, en collant le contenu du fichier texte JSON correctement formaté dans les champs de saisie de texte, puis en cliquant sur un bouton pour les sauvegarder et ensuite les utiliser.

Pour soumettre des règles personnalisées :

1. Ouvrez DevTools et sélectionnez Axe Expert. Sélectionnez Règles dans le menu principal d'Axe Expert.

2. Dans le volet de gauche, sélectionnez + Ajouter un jeu de règles dans la section Jeux de règles personnalisés du menu. Le formulaire Ruleset s'affiche dans le volet de droite.

3. Dans le champ Nom des règles personnalisées, entrez le nom alphanumérique souhaité sans espaces.

   Cela apparaîtra dans la section Ensembles de règles personnalisées du volet gauche du Rules panneau, le nom doit donc être significatif et facilement reconnaissable pour la sélection.

4. Dans le champ Entrer JSON, collez le contenu de votre fichier texte .json de règles personnalisées à partir du presse-papiers virtuel. Saisissez et faites glisser le coin inférieur droit du champ pour augmenter la zone visible, si vous le souhaitez.

5. Sélectionnez-le SAVE AND USE RULESET.

   

   Le nom que vous avez saisi apparaît dans la section Ensembles de règles personnalisés dans le volet de gauche et apparaît en haut du volet de droite, dans le champ Ensemble de règles :. De plus, des boutons permettant de supprimer ou d’utiliser l’ensemble de règles apparaissent en bas du formulaire dans le volet de droite.

   Dans le volet de droite, sélectionnez-le Analyze now.

   ![Le 'Succès ! Données de règle enregistrées.' Message apparaissant en haut à droite des outils de développement

   Le nom de l'ensemble de règles personnalisé apparaît dans le menu Règles de la barre latérale gauche, précédé d'une coche pour indiquer qu'il s'agit de l'ensemble de règles actuellement sélectionné qui sera utilisé lors de l'exécution de l'analyse.

Analyser une page pour détecter les violations des règles d'accessibilité

Le lancement d'une analyse d'accessibilité dans l'extension axe Expert se fait en naviguant vers le panneau Analyser, puis en cliquant sur le bouton Analyser. Le processus d'analyse produit un message indiquant le nombre total de violations des règles d'accessibilité trouvées sur la page, ainsi qu'une section de résultats affichant les violations des règles et le nombre total de violations identifiées. L'activation d'une ligne dans le volet de résultats de gauche affiche les détails dans le volet de contenu principal à droite. Cette action initialise également les boutons fléchés Précédent et Suivant pour les violations pour qu'ils apparaissent en haut du volet de contenu, vous permettant de naviguer d'une violation à l'autre pour n'importe quelle règle sélectionnée.

Analyser une page pour détecter les violations des règles d'accessibilité :

1. Avec l'onglet axe Expert sélectionné, sélectionnez Analyser dans le menu principal à droite du logo de l'extension axe Expert dans le volet de gauche. Le panneau Analyser apparaît.

2. Dans le volet de contenu, activez ANALYZE. Selon la manière dont vous avez ancré les outils de développement ou redimensionné la fenêtre de votre navigateur, celle-ci se trouve généralement au centre du volet gauche du panneau Analyser.

   Le volet Analyser peut afficher temporairement un message d'état indiquant Analyzing...please wait message manquant jusqu'à ce que l'analyse de la page par rapport à l'ensemble de règles sélectionné soit terminée.

   Sous le logo axe Expert Extension, le nombre total de violations détectées est affiché, ainsi que le nombre de problèmes nécessitant un examen manuel. De plus, un menu contextuel déroulant et un Run again lien s'affichent à droite du nombre total. Un tableau à deux colonnes s'affiche sous le menu contextuel déroulant 'afficher', affichant le nom abrégé de chaque règle avec la colonne de droite affichant le nombre de violations trouvées pour chacune d'elles.

   

3. Dans la section rules violated (volet de gauche), cliquez sur une ligne rule .

   

   Le volet de contenu à droite est actualisé pour afficher la première violation de cette règle. Dans l'affichage du contenu sont inclus les sections d'informations Target, HTML et Summary (How to Fix the Problem) , ainsi que des liens Inspect et Highlight , un menu contextuel (qui comprend des options pour Export, Scope, Upload et Download), et en bas à droite, un bouton fléché s'étendant vers la gauche pour afficher les normes applicables (ensembles de règles) pour la règle sélectionnée. Pour des informations plus détaillées sur chaque composant affiché dans le volet de contenu de violation de règle, reportez-vous aux descriptions dans la présentation fournie dans la rubrique Analyser . Les boutons de navigation des violations précédent < et suivant > apparaissent en haut du volet, vous permettant de naviguer entre les violations de la règle sélectionnée. De plus, le code HTML pertinent contenant la violation est automatiquement mis en évidence sur la page testée.

4. Cliquez sur Suivant (>) pour accéder à la violation suivante de la règle actuellement sélectionnée ou sélectionnez une règle différente dans le volet de résultats de règles violées à gauche, comme vous le souhaitez.

   

Supprimer un ensemble de règles personnalisé

Supprimez un ensemble de règles personnalisées du Rules panneau lorsque vous n'avez plus besoin d'un ensemble de règles personnalisées. Sélectionnez la règle à supprimer sur le Rules panneau et cliquez sur un bouton pour supprimer.

Si vous souhaitez réutiliser une partie du contenu dans un futur ensemble de règles personnalisées, vous souhaiterez peut-être vous assurer de sauvegarder le contenu du fichier JSON avant la suppression, car cette procédure entraîne une suppression permanente et irréversible.

Pour supprimer un ensemble de règles personnalisé :

1. Au bas de la liste des options dans la section Custom rulesets du panneau du volet gauche Rules , assurez-vous que l'ensemble que vous souhaitez supprimer est coché (sélectionné).
2. Cliquez DELETE RULESET.

L'ensemble est supprimé du menu du volet de gauche et n'est plus disponible pour la sélection.