Que fait Auditeur d'Accessibilité ?
Audite les applications web pour la conformité d'accessibilité (WCAG 2.1 Niveau AA) et suggère des améliorations.
Quand l'utiliser
- Lors de la construction ou de la revue de composants d'interface utilisateur
- Lorsque les utilisateurs demandent des améliorations d'accessibilité
- En préparation d'un audit d'accessibilité
- Lorsque l'utilisateur mentionne "accessibilité", "a11y", "WCAG", "lecteur d'écran" ou "navigation au clavier"
Instructions
1. Vérification du HTML sémantique
Utiliser les éléments HTML appropriés :
<!-- Mauvais -->
<div onclick="submit()">Envoyer</div>
<!-- Bon -->
<button onclick="submit()">Envoyer</button>
Structure sémantique :
<header>,<nav>,<main>,<footer><article>,<section>,<aside><h1>à<h6>dans une hiérarchie correcte<button>pour les actions,<a>pour la navigation
2. Attributs ARIA
Quand utiliser ARIA :
- Widgets personnalisés (onglets, accordéons, fenêtres modales)
- Mises à jour de contenu dynamique
- Interactions complexes
- Lorsque le HTML sémantique ne suffit pas
Attributs ARIA courants :
<!-- Rôles de repère -->
<nav role="navigation" aria-label="Principal">
<!-- Rôles de widget -->
<div role="button" tabindex="0" aria-pressed="false">
<!-- Régions live -->
<div role="alert" aria-live="assertive">Erreur survenue</div>
<!-- Étiquettes et descriptions -->
<button aria-label="Fermer la boîte de dialogue">×</button>
<input aria-describedby="aide-mot-de-passe" />
Première règle d'ARIA : Ne pas utiliser ARIA si le HTML sémantique fonctionne
3. Navigation au clavier
Tous les éléments interactifs doivent être accessibles au clavier :
// Ajouter la prise en charge clavier aux éléments personnalisés
<div
role="button"
tabindex="0"
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
handleClick();
}
}}
>
Cliquez-moi
</div>
Ordre de tabulation :
- Utiliser
tabindex="0"pour les éléments interactifs personnalisés - Éviter
tabindex > 0(crée un ordre de tabulation confus) - Utiliser
tabindex="-1"pour le focus programmatique uniquement
Gestion du focus :
- Indicateurs de focus visibles
- Piéger le focus dans les fenêtres modales
- Restituer le focus lors de la fermeture des boîtes de dialogue
- Liens d'évitement pour le contenu principal
4. Texte alternatif et images
Images informatives :
<img src="graphique.png" alt="Les ventes ont augmenté de 25 % au 3e trimestre" />
Images décoratives :
<img src="decoration.png" alt="" />
<!-- ou -->
<img src="decoration.png" role="presentation" />
Images complexes :
<figure>
<img src="graphique-complexe.png" alt="Graphique des ventes trimestriel" />
<figcaption>
Description détaillée des données du graphique...
</figcaption>
</figure>
5. Couleur et contraste
Rapports de contraste (WCAG AA) :
- Texte normal : 4,5:1 minimum
- Texte large (18pt+) : 3:1 minimum
- Composants d'interface : 3:1 minimum
Ne pas se fier uniquement à la couleur :
<!-- Mauvais : couleur uniquement -->
<span style="color: red;">Erreur</span>
<!-- Bon : icône + couleur -->
<span style="color: red;">
<svg aria-hidden="true"><!-- icône d'erreur --></svg>
<span class="sr-only">Erreur : </span>
Saisie invalide
</span>
6. Formulaires et étiquettes
Chaque champ de saisie nécessite une étiquette :
<!-- Étiquette explicite -->
<label for="email">Email</label>
<input id="email" type="email" />
<!-- Étiquette implicite -->
<label>
Email
<input type="email" />
</label>
<!-- aria-label pour les boutons avec icône -->
<button aria-label="Rechercher">
<svg><!-- icône de recherche --></svg>
</button>
Messages d'erreur :
<input
id="mot-de-passe"
aria-invalid="true"
aria-describedby="erreur-mot-de-passe"
/>
<div id="erreur-mot-de-passe" role="alert">
Le mot de passe doit comporter au moins 8 caractères
</div>
7. Titres et structure du document
Hiérarchie correcte des titres :
<h1>Titre de la page</h1>
<h2>Section 1</h2>
<h3>Sous-section 1.1</h3>
<h3>Sous-section 1.2</h3>
<h2>Section 2</h2>
Ne pas sauter de niveaux : h1 → h2 → h3 (pas h1 → h3)
8. Contenu dynamique
Annoncer les mises à jour aux lecteurs d'écran :
<!-- Poli : attendre une pause de l'utilisateur -->
<div role="status" aria-live="polite">
5 nouveaux messages
</div>
<!-- Impératif : interrompre immédiatement -->
<div role="alert" aria-live="assertive">
Votre session expirera dans 1 minute
</div>
États de chargement :
<button aria-busy="true" aria-label="Chargement...">
<span aria-hidden="true">Chargement</span>
</button>
9. Test avec lecteur d'écran
Texte réservé au lecteur d'écran :
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
Masquer les éléments décoratifs :
<svg aria-hidden="true"><!-- icône --></svg>
10. Problèmes courants à vérifier
Manquants :
- Texte alternatif sur les images
- Étiquettes sur les champs de formulaire
- Hiérarchie correcte des titres
- Indicateurs de focus clavier
- Étiquettes ARIA sur les boutons avec icône
Inappropriés :
- Texte à faible contraste
- Balisage non sémantique (divs comme boutons)
- Gestion de focus manquante dans les modales
- Pièges de tabulation
- Média en lecture automatique
Tests :
- Navigation uniquement au clavier
- Lecteur d'écran (NVDA, JAWS, VoiceOver)
- Simulation de daltonisme
- Zoom à 200 %
- Outils automatisés (axe, Lighthouse)
11. Tests automatisés
Outils :
# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility
# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com
# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com
Dans les tests :
import { axe } from 'jest-axe';
test('ne doit pas avoir de violations d\'accessibilité', async () => {
const { container } = render(<MyComponent />);
const results = await axe(container);
expect(results).toHaveNoViolations();
});
12. Checklist WCAG 2.1 Niveau AA
Perceptible :
- Alternatives textuelles pour le contenu non textuel
- Sous-titres pour l'audio/vidéo
- Contenu adaptable (balisage sémantique)
- Contraste des couleurs suffisant
Opérable :
- Accessible au clavier
- Pas de pièges de tabulation
- Limites de temps adéquates (ajustables)
- Pas de clignotement provoquant des crises
- Liens d'évitement de navigation
- Titres de page descriptifs
- Ordre de focus logique
- But du lien clair à partir du contexte
Compréhensible :
- Langue de la page spécifiée (
<html lang="fr">) - Navigation prévisible
- Aide à la saisie (étiquettes, instructions, messages d'erreur)
Robuste :
- HTML valide
- Nom, rôle, valeur pour les widgets personnalisés
- Compatible avec les technologies d'assistance
Meilleures pratiques
- Intégrer l'accessibilité dès le départ
- Tester avec de vraies technologies d'assistance
- Utiliser le HTML sémantique en premier, ARIA en second
- Maintenir une structure de document logique
- Fournir plusieurs moyens d'accéder au contenu
- Tester minutieusement la navigation au clavier
- Ne pas désactiver le zoom
- Utiliser des repères et des titres
Fichiers d'accompagnement
reference/wcag-checklist.md: Checklist complète WCAG 2.1 AAreference/aria-patterns.md: Modèles de widgets ARIA courants


