Modifier le Seuil d'Accessibilité (A11y)

A11y est une abréviation numérique (ou numéronyme) pour le mot „accessibilité“, avec „11“ (onze) représentant le nombre de caractères entre le premier „a“ et le dernier „y“ dans accessibilité. Lisez la suite pour en savoir plus sur le seuil a11y et les critères utilisés par Axe Developer Hub pour son calcul.

Qu'est-ce que le seuil A11y ?

Le seuil a11y reflète la tolérance de votre organisation aux erreurs d'accessibilité, et il est calculé à partir de deux critères :

1. Que le calcul utilise tous problèmes d'accessibilité trouvés par Axe Developer Hub lors de vos essais ou seulement nouveaux problèmes découverts lors du dernier essai. (La détection des nouveaux problèmes est uniquement disponible pour les projets web. Mobile très bientôt !)
2. Quels niveaux d'impact (Critique, Grave, Modéré et Mineur) seront inclus dans le calcul du seuil.

Le seuil a11y vous permet de personnaliser Axe Developer Hub en fonction de ce qui est important pour votre organisation. Les nouveaux problèmes sont-ils la principale préoccupation de votre organisation, ou souhaitez-vous suivre tous les problèmes ? Quels niveaux d'impact devraient être priorisés ?

Par exemple, l'objectif actuel de votre organisation peut être simplement d'atténuer les problèmes critiques, ou votre objectif peut être de corriger les deux problèmes critiques et graves. Si votre organisation débute dans le traitement des problèmes d'accessibilité, vous devrez peut-être limiter les niveaux d'impact que vous priorisez pour éviter d'être submergé. Plus tard, à mesure que les connaissances de votre organisation sur l'atténuation des problèmes d'accessibilité augmentent, vous pourrez modifier le seuil a11y pour inclure les problèmes d'accessibilité ayant un impact moindre.

Comment le seuil A11y est-il utilisé ?

Le seuil a11y offre un indicateur rapide de la qualité de l'accessibilité de votre projet et apparaît de manière proéminente lorsque vous explorez les problèmes dans Axe Developer Hub. Toute valeur supérieure à zéro dépasse le seuil d'accessibilité autorisé et indique des problèmes qui doivent être corrigés. Au fil du temps, vous pouvez suivre le seuil d'accessibilité d'un commit à l'autre, et d'une version à l'autre, pour obtenir une image de la santé d'accessibilité de votre projet.

Dans l'exemple ci-dessous, vous pouvez voir le seuil a11y calculé dans la section gauche de chaque panneau. Ici, la valeur de 2 indique deux problèmes qui dépassent le seuil actuel :

Cliquer sur la valeur du seuil a11y - ici, 2 - ajoute les problèmes avec les niveaux d'impact correspondants au filtre, afin que vous puissiez explorer uniquement les problèmes qui ont dépassé le seuil a11y. (Dans ce cas, cliquer sur 2 ajoute tous les problèmes au filtre, car tous ont été définis dans la configuration a11y.)

Configurer le Seuil A11y

Seuls les administrateurs peuvent modifier les critères du seuil a11y. Cela le changera pour tous les utilisateurs de l'entreprise.

Sur votre page Axe Account , cliquez sur l'onglet CONFIGURATION en haut de la page. Sur la page de configuration, sélectionnez Axe Developer Hub dans la liste sur le côté gauche de la page pour afficher et modifier la configuration du seuil a11y.

Après avoir modifié vos paramètres du seuil a11y, cliquez sur ENREGISTRER.

Problèmes Inclus

La valeur Problèmes Inclus indique s'il faut inclure dans le calcul du seuil tous les problèmes d'accessibilité qui répondent aux impacts sélectionnés, ou uniquement les nouveaux problèmes d'accessibilité. Les Nouveau problèmes d'accessibilité sont ceux détectés dans votre analyse actuelle qui n'ont pas été trouvés dans l'analyse à laquelle elle est comparée - qu'il s'agisse du test précédent, du commit précédent ou de la dernière analyse sur la branche par défaut. La valeur affichée pour le seuil a11y sera cohérente sur toutes les pages lorsque l'option est réglée pour inclure tous les problèmes. Lorsqu'elle est réglée pour n'examiner que les nouveaux problèmes, la valeur peut varier selon les pages, car chaque page compare son analyse contre un différent point de référence.

Note : La détection des nouveaux problèmes est disponible uniquement pour les projets web. Mobile très bientôt.

Impacts Inclus

La valeur Impacts Inclus indique quel niveau ou quels niveaux d'impact inclure dans le calcul. Les problèmes ayant un impact Critique ne peuvent pas être désélectionnés, car ces problèmes bloquent complètement les utilisateurs handicapés d'accéder à une fonctionnalité ou d'interagir avec celle-ci sur une page web ou une application mobile. En savoir plus sur tous les niveaux d'impact.

Utilisation du Seuil A11y Avec l'Action GitHub

Lors de l'utilisation du Axe Developer Hub GitHub Action pour les projets web, le seuil a11y agit comme un gardien pour bloquer les pull requests contenant des problèmes d'accessibilité. L'action ajoutera un commentaire à la pull request indiquant le problème :

Dans l'exemple ci-dessus, le commentaire de la pull request renvoie à une page sur le site Axe Developer Hub où vous pouvez voir une liste des problèmes ayant échoué. Vous pouvez modifier le comportement par défaut de l'Action GitHub pour uniquement avertir les utilisateurs des problèmes d'accessibilité au lieu de bloquer la fusion de la pull request.

Comment ça fonctionne

L'Action GitHub interroge le serveur Axe Developer Hub (via son point de terminaison REST) pour obtenir le dernier commit associé à la pull request. Le service web renvoie le nombre de problèmes d'accessibilité déterminé par les paramètres de seuil a11y. Tout nombre d'erreurs d'accessibilité supérieur à zéro est considéré comme un échec, ce qui ajoute un commentaire à la pull request et peut bloquer sa fusion.

Voir Utiliser l'Action GitHub pour plus d'informations.