Tests d'accessibilité - Gitlabhq

Édition : Gratuite, GitLab Premium, GitLab Ultimate
Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

Si votre application offre une interface web, vous pouvez utiliser GitLab CI/CD pour déterminer l'impact sur l'accessibilité des modifications de code en attente.

Pa11y est un outil gratuit et open source permettant de mesurer l'accessibilité des sites web. GitLab intègre Pa11y dans un modèle de job CI/CD. Le job a11y analyse un ensemble défini de pages web et signale les violations, avertissements et notices d'accessibilité dans un fichier nommé accessibility.

Pa11y utilise les règles WCAG 2.1.

GitLab affiche un Rapport d'accessibilité dans la zone du widget de merge request :

Configurer les tests d'accessibilité {#configure-accessibility-testing}

Vous pouvez exécuter Pa11y avec GitLab CI/CD en utilisant l'image Docker GitLab Accessibility.

Pour définir le job a11y :

Incluez le modèle Accessibility.gitlab-ci.yml depuis votre installation GitLab.

Ajoutez la configuration suivante à votre fichier .gitlab-ci.yml.

yaml

stages:
  - accessibility

variables:
  a11y_urls: "https://about.gitlab.com https://gitlab.com/users/sign_in"

include:
  - template: "Verify/Accessibility.gitlab-ci.yml"

Personnalisez la variable a11y_urls pour lister les URL des pages web à tester avec Pa11y.

Le job a11y de votre pipeline CI/CD génère les fichiers suivants :

Un rapport HTML par URL répertoriée dans la variable a11y_urls.
Un fichier contenant les données de rapport collectées. Ce fichier est nommé gl-accessibility.json.

Vous pouvez consulter les artefacts de job dans votre navigateur.

[!note] La définition du job fournie par le modèle ne prend pas en charge Kubernetes.

Vous ne pouvez pas transmettre de configurations à Pa11y via la configuration CI. Pour modifier la configuration, éditez une copie du modèle dans votre fichier CI.