Audit d'Accessibilité
Nom : a11y-audit Niveau : STANDARD Catégorie : Ingénierie - Qualité Frontend Dépendances : Python 3.8+ (Bibliothèque Standard Uniquement) Auteur : Alireza Rezvani Version : 2.1.2 Dernière mise à jour : 2026-03-18 Licence : MIT
Nom
a11y-audit -- Compétence d'audit et de correction d'accessibilité WCAG 2.2
Description
La compétence a11y-audit fournit un pipeline complet d'audit d'accessibilité pour les applications web modernes. Elle implémente un flux de travail en trois phases -- Analyser, Corriger, Vérifier -- qui identifie les violations WCAG 2.2 de Niveau A et AA, génère du code de correction exact par framework, et produit des rapports de conformité prêts pour les parties prenantes.
Cette compétence va au-delà de la détection. Pour chaque violation trouvée, elle fournit le correctif de code avant/après précis, adapté à votre framework (React, Next.js, Vue, Angular, Svelte ou HTML simple). Elle comprend qu'un attribut alt manquant sur une <img> dans du JSX React nécessite un modèle de correction différent du même problème dans un SFC Vue ou un template Angular.
Ce que fait cette compétence :
- Analyse votre base de code pour toutes les violations WCAG 2.2 de Niveau A et AA, classées par sévérité (Critique, Majeure, Mineure)
- Corrige chaque violation avec des modèles de code avant/après spécifiques au framework
- Vérifie que les corrections résolvent les violations originales et n'introduisent pas de régressions
- Rapporte les résultats dans un format structuré adapté aux développeurs, chefs de projet et parties prenantes de la conformité
- S'intègre dans les pipelines CI/CD pour prévenir les régressions d'accessibilité
Différenciateurs clés :
- Modèles de correction tenant compte du framework (pas de conseils HTML génériques)
- Analyse des contrastes de couleurs avec suggestions d'alternatives accessibles
- Couverture WCAG 2.2 incluant les nouveaux critères de succès (Apparence du Focus, Mouvements de Glissement, Taille des Cibles)
- Intégration CI/CD avec GitHub Actions, GitLab CI et Azure DevOps
- Prise en charge des commandes slash via
/a11y-audit
Fonctionnalités
Capacités de Base
| Fonctionnalité | Description |
|---|---|
| Analyse WCAG 2.2 Complète | Vérifie tous les critères de succès de Niveau A et AA dans votre base de code |
| Détection du Framework | Détecte automatiquement React, Next.js, Vue, Angular, Svelte ou HTML simple |
| Classification par Sévérité | Catégorise chaque violation comme Critique, Majeure ou Mineure |
| Génération de Code Correctif | Produit des diffs de code avant/après pour chaque problème |
| Vérificateur de Contraste des Couleurs | Valide les paires premier plan/arrière-plan par rapport aux ratios AA et AAA |
| Alternatives Accessibles | Suggère des couleurs de remplacement qui satisfont aux exigences de contraste |
| Rapports de Conformité | Génère des rapports pour les parties prenantes avec des résumés de réussite/échec |
| Intégration CI/CD | Configurations de pipeline pour GitHub Actions, GitLab CI, Azure DevOps |
| Audit de Navigation Clavier | Détecte la gestion du focus et les problèmes d'ordre de tabulation manquants |
| Validation ARIA | Vérifie les attributs ARIA incorrects, redondants ou manquants |
| Détection de Régions Live | Identifie le contenu dynamique manquant d'annonces aria-live |
| Accessibilité des Formulaires | Valide les associations d'étiquettes, les messages d'erreur et les types de saisie |
Matrice de Couverture WCAG 2.2
| Principe | Critères Niveau A | Critères Niveau AA |
|---|---|---|
| Perceptible | 1.1.1 Contenu non textuel, 1.2.1-1.2.3 Médias temporels, 1.3.1-1.3.3 Adaptable, 1.4.1-1.4.2 Distinguable | 1.3.4-1.3.5 Adaptable, 1.4.3-1.4.5 Contraste et Images de texte, 1.4.10-1.4.13 Retour à la ligne et contenu |
| Utilisable | 2.1.1-2.1.2 Clavier, 2.2.1-2.2.2 Temporisation, 2.3.1 Crises, 2.4.1-2.4.4 Navigable, 2.5.1-2.5.4 Entrée | 2.4.5-2.4.7 Navigable, 2.4.11 Apparence du Focus (NOUVEAU 2.2), 2.5.7 Glissement (NOUVEAU 2.2), 2.5.8 Taille de la cible (NOUVEAU 2.2) |
| Compréhensible | 3.1.1 Langue, 3.2.1-3.2.2 Prévisible, 3.3.1-3.3.2 Aide à la saisie | 3.1.2 Langue des parties, 3.2.3-3.2.4 Prévisible, 3.3.3-3.3.4 Gestion des erreurs, 3.3.7 Saisie redondante (NOUVEAU 2.2), 3.3.8 Authentification accessible (NOUVEAU 2.2) |
| Robuste | 4.1.2 Nom/Rôle/Valeur | 4.1.3 Messages d'état |
Définitions de Sévérité
| Sévérité | Définition | Exemple | SLA |
|---|---|---|---|
| Critique | Bloque l'accès à des groupes entiers d'utilisateurs | Texte alternatif manquant sur les images informatives, pas d'accès clavier à la navigation principale | Corriger avant la publication |
| Majeure | Barrière significative qui dégrade l'expérience | Contraste de couleurs insuffisant sur le texte du corps, étiquettes de formulaire manquantes | Corriger dans le sprint en cours |
| Mineure | Problème d'utilisabilité qui cause des frictions | Rôles ARIA redondants, hiérarchie de titres sous-optimale | Corriger dans les 2 prochains sprints |
Utilisation
Démarrage Rapide
Activez la compétence et lancez un audit sur votre projet :
# Analyser l'ensemble du projet
python scripts/a11y_scanner.py /chemin/vers/le/projet
# Analyser avec sortie JSON pour les outils
python scripts/a11y_scanner.py /chemin/vers/le/projet --json
# Vérifier le contraste des couleurs pour des valeurs spécifiques
python scripts/contrast_checker.py --fg "#777777" --bg "#ffffff"
# Vérifier le contraste dans un fichier CSS/Tailwind
python scripts/contrast_checker.py --file /chemin/vers/styles.css
Commande Slash
Utilisez la commande slash /a11y-audit pour une session d'audit interactive :
/a11y-audit # Auditer le projet en cours
/a11y-audit --scope src/ # Auditer un répertoire spécifique
/a11y-audit --fix # Auditer et appliquer automatiquement les corrections
/a11y-audit --report # Générer un rapport pour les parties prenantes
/a11y-audit --ci # Produire des résultats compatibles CI
Flux de Travail en Trois Phases
Phase 1 : Analyser
Le scanner parcourt votre arborescence source, détecte le framework utilisé et applique l'ensemble de règles approprié.
python scripts/a11y_scanner.py /chemin/vers/le/projet --format table
Exemple de sortie :
Rapport d'Audit A11Y - /chemin/vers/le/projet
Framework Détecté : React (Next.js)
Fichiers Analysés : 127
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CRITIQUE (3 problèmes)
[1.1.1] src/components/Hero.tsx:14
Texte alternatif manquant sur l'élément <img>
[2.1.1] src/components/Modal.tsx:8
Focus non piégé à l'intérieur de la boîte de dialogue modale
[1.4.3] src/styles/globals.css:42
Rapport de contraste 2.8:1 sur .subtitle (nécessite 4.5:1)
MAJEURE (7 problèmes)
[2.4.11] src/components/Button.tsx:22
Indicateur de focus non visible (contour de 2px requis)
[1.3.1] src/components/Form.tsx:31
Champ de saisie sans <label> associé
...
MINEURE (4 problèmes)
[1.3.1] src/components/Nav.tsx:5
<nav> avec rôle redondant role="navigation"
...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RÉSUMÉ : 14 violations (3 Critiques, 7 Majeures, 4 Mineures)
WCAG 2.2 Niveau A : 8 problèmes
WCAG 2.2 Niveau AA : 6 problèmes
Phase 2 : Corriger
Pour chaque violation, appliquez la correction spécifique au framework. La compétence fournit le code avant/après exact pour chaque type de problème.
Voir la section Modèles de Correction par Framework ci-dessous pour le catalogue complet des corrections.
Phase 3 : Vérifier
Relancez le scanner pour confirmer que toutes les corrections sont appliquées et qu'aucune régression n'a été introduite :
# Ré-analyser après corrections
python scripts/a11y_scanner.py /chemin/vers/le/projet --format table
# Comparer avec la référence
python scripts/a11y_scanner.py /chemin/vers/le/projet --baseline audit-baseline.json
Sortie de vérification :
RÉSULTATS DE VÉRIFICATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Analyse Précédente : 14 violations (3 Critiques, 7 Majeures, 4 Mineures)
Analyse Actuelle : 2 violations (0 Critique, 1 Majeure, 1 Mineure)
Résolu : 12 violations
Nouveaux Problèmes : 0 régressions
STATUT : AMÉLIORÉ (réduction de 85,7%)
Exemples
Exemple 1 : Audit d'un Composant React
Étant donné un composant React avec plusieurs problèmes d'accessibilité :
// AVANT : src/components/ProductCard.tsx
function ProductCard({ product }) {
return (
<div onClick={() => navigate(`/product/${product.id}`)}>
<img src={product.image} />
<div style={{ color: '#aaa', fontSize: '12px' }}>
{product.name}
</div>
<span style={{ color: '#999' }}>${product.price}</span>
</div>
);
}
Violations détectées :
| # | WCAG | Sévérité | Problème |
|---|---|---|---|
| 1 | 1.1.1 | Critique | <img> sans attribut alt |
| 2 | 2.1.1 | Critique | <div onClick> non accessible au clavier |
| 3 | 1.4.3 | Majeure | Couleur #aaa sur blanc échoue au contraste (2.32:1, besoin de 4.5:1) |
| 4 | 1.4.3 | Majeure | Couleur #999 sur blanc échoue au contraste (2.85:1, besoin de 4.5:1) |
| 5 | 4.1.2 | Majeure | Élément interactif sans rôle ni nom accessible |
// APRÈS : src/components/ProductCard.tsx
function ProductCard({ product }) {
return (
<a
href={`/product/${product.id}`}
className="product-card"
aria-label={`Voir ${product.name} - $${product.price}`}
>
<img src={product.image} alt={product.imageAlt || product.name} />
<div style={{ color: '#595959', fontSize: '12px' }}>
{product.name}
</div>
<span style={{ color: '#767676' }}>${product.price}</span>
</a>
);
}
Ce qui a changé :
<div onClick>remplacé par<a href>pour un support natif du clavier et des lecteurs d'écran- Attribut
altajouté à<img>avec un texte de remplacement pertinent aria-labelfournit le contexte complet pour les technologies d'assistance- Couleur
#aaaremplacée par#595959(rapport de contraste 7.01:1 -- passe AA et AAA) - Couleur
#999remplacée par#767676(rapport de contraste 4.54:1 -- passe AA)
Exemple 2 : Audit d'un Formulaire Vue SFC
<!-- AVANT : src/components/LoginForm.vue -->
<template>
<form @submit="handleLogin">
<input type="text" placeholder="Email" v-model="email" />
<input type="password" placeholder="Mot de passe" v-model="password" />
<div v-if="error" style="color: red">{{ error }}</div>
<div @click="handleLogin">Se connecter</div>
</form>
</template>
Violations détectées :
| # | WCAG | Sévérité | Problème |
|---|---|---|---|
| 1 | 1.3.1 | Critique | Champs de saisie sans éléments <label> associés |
| 2 | 3.3.2 | Majeure | Texte du champ utilisé comme seule étiquette (disparaît lors de la saisie) |
| 3 | 2.1.1 | Critique | <div @click> non accessible au clavier |
| 4 | 4.1.3 | Majeure | Message d'erreur non annoncé aux lecteurs d'écran |
| 5 | 3.3.1 | Majeure | Erreur non associée par programmation au champ de saisie |
<!-- APRÈS : src/components/LoginForm.vue -->
<template>
<form @submit.prevent="handleLogin" aria-label="Connexion à votre compte">
<div class="field">
<label for="login-email">Email</label>
<input
id="login-email"
type="email"
v-model="email"
autocomplete="email"
required
:aria-describedby="emailError ? 'email-error' : undefined"
:aria-invalid="!!emailError"
/>
<span v-if="emailError" id="email-error" role="alert">
{{ emailError }}
</span>
</div>
<div class="field">
<label for="login-password">Mot de passe</label>
<input
id="login-password"
type="password"
v-model="password"
autocomplete="current-password"
required
:aria-describedby="passwordError ? 'password-error' : undefined"
:aria-invalid="!!passwordError"
/>
<span v-if="passwordError" id="password-error" role="alert">
{{ passwordError }}
</span>
</div>
<div v-if="error" role="alert" aria-live="assertive" class="form-error">
{{ error }}
</div>
<button type="submit">Se connecter</button>
</form>
</template>
Exemple 3 : Audit d'un Template Angular
<!-- AVANT : src/app/dashboard/dashboard.component.html -->
<div class="tabs">
<div *ngFor="let tab of tabs"
(click)="selectTab(tab)"
[class.active]="tab.active">
{{ tab.label }}
</div>
</div>
<div class="tab-content">
<div *ngIf="selectedTab">{{ selectedTab.content }}</div>
</div>
Violations détectées :
| # | WCAG | Sévérité | Problème |
|---|---|---|---|
| 1 | 4.1.2 | Critique | Widget d'onglet sans rôles ARIA (tablist, tab, tabpanel) |
| 2 | 2.1.1 | Critique | Onglets non navigables au clavier (flèches, Début, Fin) |
| 3 | 2.4.11 | Majeure | Aucun indicateur de focus visible sur l'onglet actif |
<!-- APRÈS : src/app/dashboard/dashboard.component.html -->
<div class="tabs" role="tablist" aria-label="Sections du tableau de bord">
<button
*ngFor="let tab of tabs; let i = index"
role="tab"
[id]="'tab-' + tab.id"
[attr.aria-selected]="tab.active"
[attr.aria-controls]="'panel-' + tab.id"
[attr.tabindex]="tab.active ? 0 : -1"
(click)="selectTab(tab)"
(keydown)="handleTabKeydown($event, i)"
class="tab-button"
[class.active]="tab.active">
{{ tab.label }}
</button>
</div>
<div
*ngIf="selectedTab"
role="tabpanel"
[id]="'panel-' + selectedTab.id"
[attr.aria-labelledby]="'tab-' + selectedTab.id"
tabindex="0"
class="tab-content">
{{ selectedTab.content }}
</div>
TypeScript de support pour la navigation clavier :
// dashboard.component.ts
handleTabKeydown(event: KeyboardEvent, index: number): void {
const tabCount = this.tabs.length;
let newIndex = index;
switch (event.key) {
case 'ArrowRight':
newIndex = (index + 1) % tabCount;
break;
case 'ArrowLeft':
newIndex = (index - 1 + tabCount) % tabCount;
break;
case 'Home':
newIndex = 0;
break;
case 'End':
newIndex = tabCount - 1;
break;
default:
return;
}
event.preventDefault();
this.selectTab(this.tabs[newIndex]);
// Déplacer le focus vers le nouveau bouton d'onglet
const tabElement = document.getElementById(`tab-${this.tabs[newIndex].id}`);
tabElement?.focus();
}
Exemple 4 : Audit d'une Page Next.js
// AVANT : src/app/page.tsx
export default function Home() {
return (
<main>
<div className="text-4xl font-bold">Bienvenue chez Acme</div>
<div className="mt-4">
Construisez de meilleurs produits avec notre plateforme.
</div>
<div className="mt-8 bg-blue-600 text-white px-6 py-3 rounded cursor-pointer"
onClick={() => router.push('/signup')}>
Commencer
</div>
</main>
);
}
Violations détectées :
| # | WCAG | Sévérité | Problème |
|---|---|---|---|
| 1 | 1.1.1 | Critique | div riche en contenu non étiqueté manquant de rôle et de nom accessible |
| 2 | 2.1.1 | Critique | div cliquable non accessible au clavier |
| 3 | 1.4.1 | Majeure | Le lien n'est pas visuellement distinct sans la couleur |
// APRÈS : src/app/page.tsx
export default function Home() {
return (
<main>
<h1 className="text-4xl font-bold">Bienvenue chez Acme</h1>
<p className="mt-4">
Construisez de meilleurs produits avec notre plateforme.
</p>
<a
href="/signup"
className="mt-8 inline-block bg-blue-600 text-white px-6 py-3 rounded"
>
Commencer
</a>
</main>
);
}
Intégration CI/CD
GitHub Actions
# .github/workflows/a11y-audit.yml
name: Accessibility Audit
on:
push:
branches: [main]
pull_request:
branches: [main]
jobs:
a11y-audit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Accessibility Audit
run: |
python scripts/a11y_scanner.py . --ci --json > a11y-report.json
- name: Upload Report
uses: actions/upload-artifact@v4
with:
name: a11y-report
path: a11y-report.json
GitLab CI
# .gitlab-ci.yml
a11y-audit:
stage: test
script:
- python scripts/a11y_scanner.py . --ci --json > a11y-report.json
artifacts:
paths:
- a11y-report.json
Azure DevOps
# azure-pipelines.yml
- job: a11y_audit
pool:
vmImage: 'ubuntu-latest'
steps:
- script: |
python scripts/a11y_scanner.py . --ci --json > a11y-report.json
displayName: 'Run Accessibility Audit'
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: 'a11y-report.json'
ArtifactName: 'a11y-report'
Modèles de Correction par Framework
React / Next.js
| Problème | Code Avant | Code Après |
|---|---|---|
Image sans alt | <img src={img} /> | <img src={img} alt={imgAlt} /> |
| Div cliquable | <div onClick={fn}> | <button onClick={fn}> ou <a href="#" onClick={fn}> |
| Contraste insuffisant | color: '#aaa' | color: '#595959' // 7.01:1 |
Vue
| Problème | Code Avant | Code Après |
|---|---|---|
| Étiquette manquante | <input v-model="x"> | <label for="x-id">X</label><input id="x-id"> |
| Div cliquable | <div @click="fn"> | <button @click="fn"> |
| Erreur non annoncée | <div v-if="err"> | <div v-if="err" role="alert"> |
Angular
| Problème | Code Avant | Code Après |
|---|---|---|
| ARIA manquant | <div (click)="fn"> | <button (click)="fn" role="tab"> |
| Gestion du focus | (aucune) | [attr.tabindex]="active ? 0 : -1" |
| Navigation clavier | (aucune) | (keydown)="handleKeydown($event)" |
Svelte
| Problème | Code Avant | Code Après |
|---|---|---|
Image sans alt | <img src={img}> | <img src={img} alt={imgAlt}> |
| Contraste insuffisant | style="color: #777" | style="color: #595959" |
Considérations Techniques
- Les scripts utilisent uniquement
json,html.parser,reetosde la bibliothèque standard Python. - Aucune dépendance externe n'est requise pour l'analyse de base.
- Pour l'analyse des contrastes de couleurs, les espaces colorimétriques sRGB sont utilisés avec la formule de luminance relative WCAG.
- La détection du framework est basée sur la présence de fichiers de configuration (
package.json,angular.json,vue.config.js,svelte.config.js).
Limites Connues
- Ne peut pas effectuer d'analyses d'accessibilité dynamiques nécessitant un rendu DOM réel (analyse au niveau du code source uniquement).
- L'analyse des contrastes est basée sur des valeurs de couleur statiques dans le code source ; les couleurs déterminées dynamiquement nécessitent une vérification manuelle.
- Les modèles de correction couvrent les cas les plus courants mais peuvent ne pas gérer chaque variation de framework.
Journal des Modifications
v2.1.2 (2026-03-18)
- Ajout de la prise en charge de WCAG 2.2 pour 2.4.11 Apparence du Focus, 2.5.7 Glissement, 2.5.8 Taille de la cible
- Amélioration de la détection du framework pour Next.js 14+ et Nuxt 3
- Nouvelle commande slash
/a11y-audit --fixpour application automatisée des correctifs - Correction d'un bug dans l'analyse des contrastes pour les couleurs hexadécimales courtes
v2.0.0 (2025-11-01)
- Refonte complète : architecture en trois phases (Analyser / Corriger / Vérifier)
- Ajout de modèles de correction spécifiques aux frameworks pour React, Vue, Angular, Svelte
- Intégration CI/CD avec génération de rapports
- Nouveau système de notation de conformité
v1.0.0 (2025-06-15)
- Version initiale avec analyse WCAG 2.1 et suggestions de correction de base