📖 Manuel
Accessibility Checker
Workflow
- Audit des critères WCAG 2.1 niveau AA : parcourir les quatre principes — Perceivable (contenu perceptible), Operable (interface utilisable), Understandable (contenu compréhensible), Robust (compatible technologies d'assistance) — et identifier les violations par niveau de criticité.
- Navigation clavier : vérifier l'ordre de tabulation logique (tab order suit le flux visuel), que le focus est toujours visible (
outlinenon supprimé), que des skip links existent pour sauter la navigation, et qu'aucune keyboard trap ne bloque l'utilisateur.
- Sémantique HTML : contrôler l'utilisation correcte des landmarks (
<main>,<nav>,<header>,<footer>), la hiérarchie des titres (h1 > h2 > h3 sans saut), les labels associés aux champs, et les rôles implicites des éléments natifs.
- ARIA correctement utilisé : s'assurer que
aria-label,aria-describedby,aria-expanded,aria-controlset les live regions (aria-live) sont appliqués uniquement là où le HTML natif ne suffit pas — pas d'ARIA redondant ou incorrect.
- Contrastes et couleurs : vérifier le ratio de contraste (minimum 4.5:1 pour le texte normal, 3:1 pour les grands textes ≥18px), s'assurer que l'information n'est jamais transmise par la couleur seule, et tester en mode daltonien.
- Images et médias : valider les textes alternatifs (
alt) informatifs pour les images porteuses de sens,alt=""pour les images décoratives, sous-titres pour les vidéos, audio descriptions pour les contenus visuels complexes, et transcriptions pour les podcasts.
- Formulaires accessibles : associer chaque champ à son
<label>viafor/id, fournir des messages d'erreur clairs liés au champ (aria-describedby), ne pas bloquer la validation sur le seul format visuel, et permettre la correction avant soumission.
- Tests avec outils : intégrer axe-core ou Lighthouse pour les tests automatisés, tester manuellement avec NVDA (Windows) et VoiceOver (macOS/iOS), et ajouter pa11y-ci dans la pipeline CI/CD pour prévenir les régressions.
Règles
- L'accessibilité est une exigence légale dans de nombreux pays : traiter chaque violation comme un bug critique.
- Préférer le HTML sémantique natif à ARIA — un
<button>vaut mieux qu'un<div role="button">. - Tester avec de vrais lecteurs d'écran, pas uniquement des outils automatisés (qui ne détectent que ~30% des problèmes).
- Fournir des exemples de code corrigé, pas seulement la liste des problèmes.
- Documenter le niveau WCAG (A, AA, AAA) et le critère exact (ex. 1.4.3 Contrast) pour chaque point soulevé.