Modèles d'audit WCAG
Guide complet pour auditer le contenu web selon les directives WCAG 2.2, avec des stratégies de correction actionnables.
Quand utiliser cette compétence
- Réaliser des audits d'accessibilité
- Corriger des violations WCAG
- Implémenter des composants accessibles
- Se préparer à des poursuites liées à l'accessibilité
- Satisfaire aux exigences ADA/Section 508
- Atteindre la conformité VPAT
Concepts fondamentaux
1. Niveaux de conformité WCAG
| Niveau | Description | Requis pour |
|---|---|---|
| A | Accessibilité minimale | Base légale |
| AA | Conformité standard | La plupart des réglementations |
| AAA | Accessibilité renforcée | Besoins spécialisés |
2. Principes POUR
Perceptible : Les utilisateurs peuvent-ils percevoir le contenu ?
Utilisable : Les utilisateurs peuvent-ils utiliser l'interface ?
Compréhensible : Les utilisateurs peuvent-ils comprendre le contenu ?
Robuste : Fonctionne-t-il avec les technologies d'assistance ?
3. Violations courantes par impact
Critiques (Blocants) :
├── Texte alternatif manquant pour les images fonctionnelles
├── Pas d'accès clavier aux éléments interactifs
├── Étiquettes de formulaire manquantes
└── Médias en lecture automatique sans contrôles
Graves :
├── Contraste de couleur insuffisant
├── Liens d'évitement manquants
├── Widgets personnalisés inaccessibles
└── Titres de page manquants
Modérées :
├── Attribut de langue manquant
├── Texte de lien peu clair
├── Points de repère manquants
└── Hiérarchie de titres incorrecte
Liste de contrôle d'audit
Perceptible (Principe 1)
## 1.1 Équivalents textuels
### 1.1.1 Contenu non textuel (Niveau A)
- [ ] Toutes les images ont un texte alternatif
- [ ] Les images décoratives ont alt=""
- [ ] Les images complexes ont des descriptions longues
- [ ] Les icônes avec signification ont des noms accessibles
- [ ] Les CAPTCHAs ont des alternatives
Vérification :
```html
<!-- Bon -->
<img src="chart.png" alt="Les ventes ont augmenté de 25% du T1 au T2" />
<img src="decorative-line.png" alt="" />
<!-- Mauvais -->
<img src="chart.png" />
<img src="decorative-line.png" alt="ligne décorative" />
```
1.2 Médias temporels
1.2.1 Audio seulement et Vidéo seulement (Niveau A)
- L'audio a une transcription textuelle
- La vidéo a une description audio ou une transcription
1.2.2 Sous-titres (Niveau A)
- Toute vidéo a des sous-titres synchronisés
- Les sous-titres sont précis et complets
- Identification des intervenants incluse
1.2.3 Description audio (Niveau A)
- La vidéo a une description audio pour le contenu visuel
1.3 Adaptable
1.3.1 Information et relations (Niveau A)
- Les titres utilisent des balises appropriées (h1-h6)
- Les listes utilisent ul/ol/dl
- Les tableaux ont des en-têtes
- Les entrées de formulaire ont des étiquettes
- Points de repère ARIA présents
Vérification :
<!-- Hiérarchie de titres -->
<h1>Titre de page</h1>
<h2>Section</h2>
<h3>Sous-section</h3>
<h2>Autre section</h2>
<!-- En-têtes de tableau -->
<table>
<thead>
<tr>
<th scope="col">Nom</th>
<th scope="col">Prix</th>
</tr>
</thead>
</table>
1.3.2 Ordre significatif (Niveau A)
- L'ordre de lecture est logique
- Le positionnement CSS ne casse pas l'ordre
- L'ordre de tabulation correspond à l'ordre visuel
1.3.3 Caractéristiques sensorielles (Niveau A)
- Les instructions ne reposent pas uniquement sur la forme/la couleur
- "Cliquez sur le bouton rouge" → "Cliquez sur Valider (bouton rouge)"
1.4 Distinguable
1.4.1 Utilisation de la couleur (Niveau A)
- La couleur n'est pas le seul moyen de transmettre une information
- Les liens sont distinguables sans couleur
- Les états d'erreur ne se basent pas uniquement sur la couleur
1.4.3 Contraste (Minimum) (Niveau AA)
- Texte : rapport de contraste de 4,5:1
- Grand texte (18pt+) : rapport de 3:1
- Composants UI : rapport de 3:1
Outils : Vérificateur de contraste WebAIM, axe DevTools
1.4.4 Redimensionnement du texte (Niveau AA)
- Le texte se redimensionne à 200% sans perte
- Pas de défilement horizontal à 320px
- Le contenu se réorganise correctement
1.4.10 Réorganisation (Niveau AA)
- Le contenu se réorganise à 400% de zoom
- Pas de défilement bidimensionnel
- Tout le contenu est accessible à 320px de largeur
1.4.11 Contraste du contenu non textuel (Niveau AA)
- Les composants UI ont un contraste de 3:1
- Les indicateurs de focus sont visibles
- Les objets graphiques sont distinguables
1.4.12 Espacement du texte (Niveau AA)
- Pas de perte de contenu avec un espacement accru
- Hauteur de ligne de 1,5x la taille de police
- Espacement de paragraphe de 2x la taille de police
- Espacement des lettres de 0,12x la taille de police
- Espacement des mots de 0,16x la taille de police
### Utilisable (Principe 2)
```markdown
## 2.1 Accessible au clavier
### 2.1.1 Clavier (Niveau A)
- [ ] Toute fonctionnalité accessible au clavier
- [ ] Pas de piège clavier
- [ ] L'ordre de tabulation est logique
- [ ] Les widgets personnalisés sont opérables au clavier
Vérification :
```javascript
// Un bouton personnalisé doit être accessible au clavier
<div role="button" tabindex="0"
onkeydown="if(event.key === 'Enter' || event.key === ' ') activate()">
```
### 2.1.2 Pas de piège clavier (Niveau A)
- [ ] Le focus peut être déplacé de tout composant
- [ ] Les boîtes de dialogue modales capturent correctement le focus
- [ ] Le focus revient après la fermeture de la fenêtre modale
## 2.2 Délai suffisant
### 2.2.1 Ajustement du délai (Niveau A)
- [ ] Les délais de session peuvent être prolongés
- [ ] L'utilisateur est averti avant l'expiration
- [ ] Option pour désactiver l'actualisation automatique
### 2.2.2 Pause, arrêter, masquer (Niveau A)
- [ ] Le contenu en mouvement peut être mis en pause
- [ ] Le contenu mis à jour automatiquement peut être mis en pause
- [ ] Les animations respectent prefers-reduced-motion
```css
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
}
}
```
## 2.3 Convulsions et réactions physiques
### 2.3.1 Trois flashs (Niveau A)
- [ ] Aucun contenu ne flashe plus de 3 fois par seconde
- [ ] La zone de flash est petite (<25% de la zone d'affichage)
## 2.4 Navigable
### 2.4.1 Contournement des blocs (Niveau A)
- [ ] Lien pour passer au contenu principal présent
- [ ] Régions de point de repère définies
- [ ] Structure de titres appropriée
```html
<a href="#main" class="skip-link">Passer au contenu principal</a>
<main id="main">...</main>
```
### 2.4.2 Titre de page (Niveau A)
- [ ] Titres de page uniques et descriptifs
- [ ] Le titre reflète le contenu de la page
### 2.4.3 Ordre de tabulation (Niveau A)
- [ ] L'ordre de tabulation correspond à l'ordre visuel
- [ ] tabindex utilisé correctement
### 2.4.4 Objectif du lien (en contexte) (Niveau A)
- [ ] Les liens ont du sens hors contexte
- [ ] Pas de "cliquez ici" ou "en savoir plus" seul
```html
<!-- Mauvais -->
<a href="report.pdf">Cliquez ici</a>
<!-- Bon -->
<a href="report.pdf">Télécharger le rapport des ventes T4 (PDF)</a>
```
### 2.4.6 Titres et étiquettes (Niveau AA)
- [ ] Les titres décrivent le contenu
- [ ] Les étiquettes décrivent le but
### 2.4.7 Focus visible (Niveau AA)
- [ ] Indicateur de focus visible sur tous les éléments
- [ ] Les styles de focus personnalisés respectent le contraste
```css
:focus {
outline: 3px solid #005fcc;
outline-offset: 2px;
}
```
### 2.4.11 Focus non masqué (Niveau AA) - WCAG 2.2
- [ ] L'élément focalisé n'est pas complètement caché
- [ ] Les en-têtes fixes ne masquent pas le focus
Compréhensible (Principe 3)
## 3.1 Lisible
### 3.1.1 Langue de la page (Niveau A)
- [ ] Attribut lang HTML défini
- [ ] La langue est correcte pour le contenu
```html
<html lang="fr">
3.1.2 Langue des passages (Niveau AA)
- Les changements de langue sont marqués
<p>Le mot anglais <span lang="en">hello</span> signifie bonjour.</p>
3.2 Prévisible
3.2.1 Au focus (Niveau A)
- Pas de changement de contexte sur le seul focus
- Pas de popups inattendues au focus
3.2.2 À l'entrée (Niveau A)
- Pas de soumission automatique de formulaire
- L'utilisateur est averti avant le changement de contexte
3.2.3 Navigation cohérente (Niveau AA)
- Navigation cohérente sur toutes les pages
- Composants répétés dans le même ordre
3.2.4 Identification cohérente (Niveau AA)
- Même fonctionnalité = même étiquette
- Icônes utilisées de manière cohérente
3.3 Assistance à la saisie
3.3.1 Identification des erreurs (Niveau A)
- Les erreurs sont clairement identifiées
- Le message d'erreur décrit le problème
- L'erreur est liée au champ
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Veuillez saisir un email valide</span>
3.3.2 Étiquettes ou instructions (Niveau A)
- Toutes les entrées ont des étiquettes visibles
- Les champs obligatoires sont indiqués
- Indications de format fournies
3.3.3 Suggestion d'erreur (Niveau AA)
- Les erreurs incluent une suggestion de correction
- Les suggestions sont spécifiques
3.3.4 Prévention des erreurs (Niveau AA)
- Les formulaires juridiques/financiers sont réversibles
- Les données sont vérifiées avant soumission
- L'utilisateur peut examiner avant de soumettre
### Robuste (Principe 4)
```markdown
## 4.1 Compatible
### 4.1.1 Analyse (Niveau A) - Obsolète dans WCAG 2.2
- [ ] HTML valide (bonne pratique)
- [ ] Pas d'IDs en double
- [ ] Balises d'ouverture/fermeture complètes
### 4.1.2 Nom, rôle, valeur (Niveau A)
- [ ] Les widgets personnalisés ont des noms accessibles
- [ ] Rôles ARIA corrects
- [ ] Les changements d'état sont annoncés
```html
<!-- Case à cocher personnalisée accessible -->
<div role="checkbox"
aria-checked="false"
tabindex="0"
aria-labelledby="label">
</div>
<span id="label">Accepter les conditions</span>
```
### 4.1.3 Messages d'état (Niveau AA)
- [ ] Les mises à jour d'état sont annoncées
- [ ] Les régions live sont utilisées correctement
```html
<div role="status" aria-live="polite">3 articles ajoutés au panier</div>
<div role="alert" aria-live="assertive">Erreur : Échec de la soumission du formulaire</div>
```
Tests automatisés
// Intégration axe-core
const axe = require('axe-core');
async function runAccessibilityAudit(page) {
await page.addScriptTag({ path: require.resolve('axe-core') });
const results = await page.evaluate(async () => {
return await axe.run(document, {
runOnly: {
type: 'tag',
values: ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa']
}
});
});
return {
violations: results.violations,
passes: results.passes,
incomplete: results.incomplete
};
}
// Exemple de test Playwright
test('ne doit pas avoir de violations d'accessibilité', async ({ page }) => {
await page.goto('/');
const results = await runAccessibilityAudit(page);
expect(results.violations).toHaveLength(0);
});
# Outils CLI
npx @axe-core/cli https://exemple.com
npx pa11y https://exemple.com
lighthouse https://exemple.com --only-categories=accessibility
Modèles de correction
Correction : Étiquettes de formulaire manquantes
<!-- Avant -->
<input type="email" placeholder="Email" />
<!-- Après : Option 1 - Étiquette visible -->
<label for="email">Adresse email</label>
<input id="email" type="email" />
<!-- Après : Option 2 - aria-label -->
<input type="email" aria-label="Adresse email" />
<!-- Après : Option 3 - aria-labelledby -->
<span id="email-label">Email</span>
<input type="email" aria-labelledby="email-label" />
Correction : Contraste de couleur insuffisant
/* Avant : 2,5:1 de contraste */
.text {
color: #767676;
}
/* Après : 4,5:1 de contraste */
.text {
color: #595959;
}
/* Ou ajouter un fond */
.text {
color: #767676;
background: #000;
}
Correction : Navigation au clavier
// Rendre un élément personnalisé accessible au clavier
class AccessibleDropdown extends HTMLElement {
connectedCallback() {
this.setAttribute("tabindex", "0");
this.setAttribute("role", "combobox");
this.setAttribute("aria-expanded", "false");
this.addEventListener("keydown", (e) => {
switch (e.key) {
case "Enter":
case " ":
this.toggle();
e.preventDefault();
break;
case "Escape":
this.close();
break;
case "ArrowDown":
this.focusNext();
e.preventDefault();
break;
case "ArrowUp":
this.focusPrevious();
e.preventDefault();
break;
}
});
}
}
Bonnes pratiques
À faire
- Commencer tôt - Accessibilité dès la phase de conception
- Tester avec des utilisateurs réels - Les personnes handicapées fournissent les meilleurs retours
- Automatiser ce qui peut l'être - 30 à 50% des problèmes détectables
- Utiliser du HTML sémantique - Réduit les besoins en ARIA
- Documenter les modèles - Créer une bibliothèque de composants accessibles
À ne pas faire
- Ne pas se fier uniquement aux tests automatisés - Les tests manuels sont nécessaires
- Ne pas utiliser ARIA comme première solution - Privilégier le HTML natif d'abord
- Ne pas masquer les contours de focus - Les utilisateurs du clavier en ont besoin
- Ne pas désactiver le zoom - Les utilisateurs doivent pouvoir redimensionner
- Ne pas utiliser la couleur seule - Plusieurs indicateurs nécessaires

