Modifier le seuil d'accessibilité (A11y)
Comment modifier le seuil d'accessibilité pour personnaliser la manière dont votre organisation traite les problèmes d'accessibilité
Cet article décrit le seuil d'accessibilité (a11y) et comment modifier les critères utilisés par axe Developer Hub pour calculer le seuil a11y.
Quel est le seuil A11y ?
Le seuil a11y reflète la tolérance de votre organisation aux erreurs d'accessibilité et est un nombre calculé à partir de deux critères :
- Si le calcul utilise tous les problèmes d'accessibilité détectés par axe Developer Hub lors de vos exécutions de test ou uniquement les nouveaux problèmes découverts lors de la dernière exécution de test.
- Quels impacts (critiques, graves, modérés et mineurs) seront inclus dans le calcul du seuil.
Si vous modifiez l'un des critères du seuil a11y, la modification affecte uniquement les calculs à venir et non les calculs passés ; les valeurs de seuil a11y plus anciennes ne sont pas recalculées. Une icône apparaîtra à côté du calcul pour indiquer que la configuration a changé, et si vous passez votre curseur dessus, vous serez rappelé que le seuil a changé :
Le seuil a11y vous permet de personnaliser axe Developer Hub en fonction de ce qui compte 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 impacts comptent pour votre organisation ?
Par exemple, vous souhaitez peut-être uniquement atténuer les problèmes critiques ou vous souhaitez peut-être uniquement traiter * les problèmes critiques et graves* . Peut-être que votre organisation commence tout juste à aborder les problèmes d’accessibilité, vous devez donc limiter les impacts pour éviter d’être débordé. Plus tard, à mesure que les connaissances de votre organisation en matière d’atténuation des problèmes d’accessibilité augmentent, vous pouvez ajouter des impacts graves (ou modérés ou mineurs).
Comment le seuil A11y est-il utilisé ?
Le seuil a11y fournit une évaluation rapide de la qualité d'accessibilité de votre projet et apparaît en évidence sur tout le site axe Developer Hub. Toute valeur supérieure à zéro dépasse le seuil d'accessibilité autorisé et indique des problèmes qui doivent être résolus. Au fil du temps, vous pouvez suivre le seuil d'accessibilité d'un commit à l'autre et d'une version à l'autre pour développer une vue d'ensemble de la santé de l'accessibilité de votre projet.
Les pages suivantes montrent le seuil d'accessibilité :
- Branches page
- Commits page
- Exécutions de tests page
- Problèmes page
L'exemple suivant montre comment le seuil a11y calculé est affiché dans la section gauche de chaque panneau (ici, il y a deux problèmes au-dessus du seuil) :
En cliquant sur la valeur du seuil a11y (ici, 2), les impacts sont ajoutés au filtre, ce qui vous permet d'accéder uniquement aux problèmes qui ont entraîné le dépassement du seuil a11y. (Dans ce cas, cliquer sur 2 a ajouté tous les impacts au filtre car tous ont été définis dans la configuration a11y.)
Comment changer
Sur votre page de compte axe cliquez sur l'onglet CONFIGURATION en haut de la page :
Vous verrez la page de configuration. Sélectionnez axe Developer Hub dans la liste sur le côté gauche de la page pour voir la configuration du seuil a11y :
Les titulaires de compte individuels peuvent modifier les critères de seuil a11y, mais si vous faites partie d'une entreprise, vous devez être un administrateur d'entreprise pour les modifier.
La modification du seuil d'accessibilité en tant qu’administrateur d’entreprise le modifiera pour tous les utilisateurs de l’entreprise.
Après avoir modifié vos paramètres de seuil d'accessibilité, cliquez sur ENREGISTRER.
Vous ne pouvez pas désélectionner critiques dans la liste des impacts, car les problèmes critiques entraînent le blocage du contenu pour les personnes handicapées et les empêchent d'accéder aux fonctionnalités ou au contenu fondamentaux.
Problèmes inclus
La valeur Problèmes inclus indique si les problèmes doivent être inclus dans le calcul du seuil
- tous les problèmes d'accessibilité qui correspondent aux impacts sélectionnés ou
- seulement les nouveaux .
Impacts inclus
La valeur inclus impacts indique le ou les niveaux d'impact à inclure dans le calcul.
Dans l'implémentation actuelle, les paramètres de seuil a11y sont complètement indépendants des paramètres d'accessibilité globaux (sur l'onglet Global de la page Configuration ) (mais cela peut changer à l'avenir). La modification des paramètres dans l'onglet Global ne modifiera pas le seuil d'accessibilité (ou vice versa).
Utilisation du seuil d'accessibilité avec l'action GitHub
Vous pouvez utiliser le seuil d'accessibilité avec l'action GitHub axe Developer Hub pour agir comme un gardien afin de bloquer, par défaut, les demandes d'extraction contenant des problèmes d'accessibilité dépassant le seuil d'accessibilité. L'action ajoutera un commentaire à la demande d'extraction indiquant le problème :
Dans l'exemple de commentaire PR ci-dessus, le lien vous dirige vers la page Incidents sur le site Web axe Developer Hub pour voir les incidents qui ont causé l'échec de cette PR. Vous pouvez également modifier le comportement par défaut pour avertir uniquement les utilisateurs des problèmes d'accessibilité au lieu de bloquer la fusion de la PR.
Comment ça marche
L'action GitHub interroge le serveur axe Developer Hub (via son point de terminaison REST) pour le dernier commit associé à cette demande d'extraction (PR). Le service Web renvoie le nombre de problèmes d’accessibilité tel que déterminé par les paramètres de seuil a11y. Par défaut, tout nombre d'erreurs d'accessibilité supérieur à zéro est considéré comme un échec, ce qui entraîne l'ajout d'un commentaire tel que celui ci-dessus à la pull request et le blocage de la fusion de la pull request.
Consultez Utilisation de l'action GitHub pour plus d'informations.