Utilisation des résultats d'accessibilité avec Java

Il existe pratiquement d'innombrables façons d'exploiter les résultats d'un scan Axe DevTools

Tous les scans d'accessibilité basés sur axe-core peuvent être configurés pour renvoyer leurs résultats sous forme d'objet JSON. Ce format le rend facile à utiliser pour les débutants en accessibilité web, contient la profondeur d'information dont les experts en la matière ont besoin, et permet la génération automatisée de rapports et de tests personnalisés même en dehors d'un format de test standard basé sur les assertions.

Générer l'objet résultats

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

Aperçu des résultats

Méta

L'objet résultats commence par des informations méta utiles. Cela inclut le nom du test, l'adresse web de la page testée, la date et l'heure de réalisation du test, l'ensemble de règles axe-core utilisé, et plus encore.

Constats

Le début des résultats est marqué par le titre "constats". Il y a quatre types de résultats, chacun avec leur propre tableau. Ces types de résultats sont inapplicable, incomplet, réussi et violation. De plus, il y a certaines données spécifiques au test situées immédiatement avant le tableau des violations.

Inapplicable

Inapplicable signifie qu'il n'y avait pas de 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 ils devraient finalement être classés. Un cas d'incomplet fréquent est les vérifications du contraste des couleurs sur des éléments avec des arrière-plans colorés variables où il n'est pas toujours évident de savoir si le contraste suffisant est atteint. Les problèmes dans cette catégorie ne doivent pas être automatiquement considérés comme des violations, car ils peuvent l'être ou non. Pour les utilisateurs ayant une meilleure connaissance de l'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 vérifiées qui n'ont trouvé aucune violation d'accessibilité associée. Associé à chaque règle réussie, il y aura un tableau d'éléments de page qui ont été vérifiés contre la règle et ont passé.

Violations

Le tableau des violations contient toutes les violations d'accessibilité trouvées lors du scan. Grâce à la politique de Deque de zéro faux positif, tout résultat trouvé ici est garanti d'être authentique. Chaque violation contient plus d'informations sur laquelle est la violation, où elle se situe sur la page, des suggestions pour la corriger, et plus encore. Consultez la référence du champ ci-dessous pour plus d'informations.

Référence des champs - Réussites et Violations

• description — Chaîne de texte qui décrit ce que fait la règle
• help — Texte d'aide qui décrit 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 Deque University.
• id — Identifiant unique pour la règle ; voir la liste des règles.
• impact — Gravité de la violation. Peut être l'une des options mineur, modéré, sérieux ou critique si le test a échoué ou null si le contrôle a réussi
• tags — Tableau de balises attribuées à cette règle. Ces balises peuvent être utilisées dans la structure d'options pour sélectionner les règles à exécuter.
• nodes — Tableau de tous les éléments testés par la Règle
  • html — Extrait HTML de l'élément
  • impact — Gravité de la violation. Peut être l'une des options mineur, modéré, sérieux ou critique si le test a échoué ou null si le contrôle a réussi
  • cible — Tableau de sélecteurs ayant chaque élément correspondant à un niveau de iframe ou frame. S'il y a un iframe ou frame, il devrait y avoir deux entrées dans cible. S'il y a trois niveaux de iframe, il devrait y avoir quatre entrées dans cible.
  • any — Tableau de vérifications effectuées où au moins une doit avoir réussi. Chaque entrée du tableau contient :
  • id — Identifiant unique pour cette vérification. Les identifiants de vérification peuvent être les mêmes que ceux des Règles
  • impact — Gravité de cette vérification particulière. Peut être l'une des options mineur, modéré, sérieux ou critique. Chaque vérification qui fait partie d'une règle peut avoir des impacts différents. L'impact le plus élevé de toutes les vérifications qui échouent est rapporté pour la règle
  • message — Description de la raison pour laquelle cette vérification a réussi ou échoué
  • data — Informations supplémentaires spécifiques au type de vérification qui sont facultatives. Par exemple, une vérification de contraste de couleurs inclurait la couleur de premier plan, la couleur d'arrière-plan, le rapport de contraste, etc.
  • relatedNodes — Tableau optionnel d'informations sur d'autres nœuds liés à cette vérification. Par exemple, une violation de vérification d'identifiant dupliqué listerait les autres sélecteurs qui avaient le même identifiant dupliqué. Chaque entrée du tableau contient les informations suivantes :
    • cible — Tableau de sélecteurs pour le nœud lié
    • html — Source HTML du nœud lié
  • all — Tableau de vérifications effectuées où toutes doivent avoir réussi. Chaque entrée du tableau contient les mêmes informations que le tableau any
  • none — Tableau de vérifications effectuées où aucune ne doit avoir réussi. Chaque entrée du tableau contient les mêmes informations que le tableau any

Utilisation des résultats

Deque facilite le partage et la compréhension des résultats de vos scans avec notre rapporteur. Il est configurable pour produire des rapports en HTML, JUnit XML ou CSV et, une fois configuré, génère des rapports automatiquement. Voir 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 assertions de violations d'accessibilité standard, vous pouvez découper l'objet de résultats selon les violations, leur gravité, leur impact, le jeu de règles associé, ou n'importe quel 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.