Utilisation des résultats d'accessibilité avec Java

Il existe un nombre pratiquement illimité de façons d'exploiter les résultats d'une analyse axe DevTools

Toutes les analyses d'accessibilité pilotées par axe-core peuvent être configurées pour les retourner sous forme d'objet JSON. Ce format signifie qu'il est facile à comprendre pour les nouveaux venus dans l'accessibilité Web, contient la profondeur des informations dont les experts chevronnés en la matière ont besoin et permet la génération de rapports automatisés et des tests personnalisés même en dehors d'un format de test basé sur des conditions standard.

Génération de l'objet de résultats

Pour générer l'objet de résultats, voir Générer des rapports avec Java

Aperçu des résultats

Meta

L'objet de résultats commence par quelques méta-informations utiles. Cela inclut le nom du test, l'adresse Web de la page testée, la date et l'heure d'exécution du test, l'ensemble de règles axe-core utilisé, etc.

Résultats

Le début des résultats est délimité par la rubrique « Résultats ». Il existe quatre types de résultats, chacun avec son propre tableau. Ces types de résultats sont inapplicable, incomplet, passé et violation. De plus, certaines données spécifiques au test sont situées immédiatement avant le tableau des violations.

Inapplicable

Non applicable signifie qu'il n'y avait aucun contenu de page pertinent pour ce test particulier, comme des tests liés aux formulaires sur une page sans formulaires.

Incomplet

Incomplets sont des tests qui ont été exécutés, mais dont les résultats nécessitent un examen plus approfondi pour déterminer dans quelle catégorie les résultats doivent finalement être classés. Une occurrence incomplète courante est la vérification du contraste des couleurs sur des éléments avec des arrière-plans de couleurs variables où il n'est pas toujours clair si le contraste est suffisant. Les problèmes de cette catégorie ne doivent pas être traités automatiquement comme des violations, car ils peuvent l’être ou non. Pour les utilisateurs disposant de plus de connaissances en matière d’accessibilité, un examen plus approfondi de ces résultats peut aider à trouver des violations supplémentaires qui ne peuvent pas être testées automatiquement.

Réussites

Ce groupe de résultats énumère les règles qui ont été vérifiées et n'ont pas trouvé de violations d'accessibilité associées. À chaque règle validée sera associé un tableau d'éléments de page qui ont été vérifiés par rapport à la règle et validés.

Infractions

Le tableau des violations contient toutes les violations d’accessibilité détectées lors de l’analyse. Grâce à la politique de zéro faux positif de Deque, tout résultat trouvé ici est garanti comme étant réel. Chaque violation contient des informations supplémentaires sur la nature de la violation, son emplacement sur la page, des suggestions sur la façon de la résoudre, et bien plus encore. Voir la référence de champ ci-dessous pour plus d'informations.

Référence de champ - Réussites et violations

• description — Chaîne de texte qui décrit ce que fait la règle
• aide — Texte d'aide décrivant le test effectué
• helpUrl — URL qui fournit plus d’informations sur les spécificités de la violation. Liens vers une page sur le site de Deque University.
• id — Identifiant unique de la règle ; voir la liste des règles.
• impact — La gravité de la violation. Peut être : mineur, modéré, grave, critique si le test a échoué ou nul si le contrôle a réussi
• tags — Tableau de balises auxquelles cette règle est attribuée. Ces balises peuvent être utilisées dans la structure des options pour sélectionner les règles à exécuter.
• nœuds — Tableau de tous les éléments testés par la règle
  • html — Extrait de code HTML de l'élément
  • impact — La gravité de la violation. Peut être : mineur, modéré, grave, critique si le test a échoué ou nul si le contrôle a réussi
  • target — Tableau de sélecteurs dont chaque élément correspond à un niveau d'iframe ou de frame. S'il y a un iframe ou un cadre, il doit y avoir deux entrées dans l'objectif. S'il y a trois niveaux d'iframe, il devrait y avoir quatre entrées dans l'objectif.
  • any — Ensemble de contrôles qui ont été effectués et dont au moins un doit avoir réussi. Chaque entrée du tableau contient :
  • id — Identifiant unique pour ce contrôle. Les identifiants de contrôle peuvent être identiques aux identifiants de règle
  • impact — La gravité de cette vérification particulière. Peut être mineur, modéré, grave ou critique. Chaque vérification faisant partie d'une règle peut avoir des impacts différents. L'impact le plus élevé de toutes les vérifications qui échouent est signalé pour la règle
  • message — Description de la raison pour laquelle ce contrôle a réussi ou échoué
  • données — Informations supplémentaires spécifiques au type de contrôle et facultatives. Par exemple, une vérification du contraste des couleurs inclurait la couleur de premier plan, la couleur d'arrière-plan, le rapport de contraste, etc.
  • relatedNodes — Tableau facultatif d'informations sur les autres nœuds liés à cette vérification. Par exemple, une violation de vérification d'identifiant en double répertorierait les autres sélecteurs qui avaient ce même identifiant en double. Chaque entrée du tableau contient les informations suivantes :
    • target — Tableau de sélecteurs pour le nœud associé
    • html — source HTML du nœud associé
  • all — Tableau de contrôles qui ont été effectués et où tous doivent avoir réussi. Chaque entrée du tableau contient les mêmes informations que le tableau 'any'
  • aucun — Ensemble de vérifications qui ont été effectuées où tous doivent avoir échoué. Chaque entrée du tableau contient les mêmes informations que le tableau 'any'

Utilisation des résultats

Deque facilite le partage et l'analyse des résultats de vos analyses avec notre rapporteur. Il est configurable pour produire des rapports HTML, JUnit XML ou CSV et une fois configuré, renvoie automatiquement des rapports. Consultez le guide sur les rapports pour savoir comment configurer et utiliser le rapporteur.

De plus, l'objet de résultats JSON facilite l'écriture de vos propres tests personnalisés. Au-delà des affirmations de violation d'accessibilité standard, vous pouvez découper l'objet de résultats par violations, leur gravité, leur impact, leur ensemble de règles associé ou l'un des paramètres de l'objet de résultats. Toutes les données présentées dans l’objet de résultats peuvent donc être testées.