Accessibilité qui vient avec le métier
L'accessibilité n'est pas une case à cocher vissée à la fin ; c'est le socle du métier d'interface. La plupart des efforts sont gratuits si vous utilisez la plateforme : les éléments natifs embarquent le support clavier, les vrais labels s'annoncent, et un anneau de focus visible n'est qu'une règle CSS. Appliquez ces principes lors de la construction ou la révision de code UI, et adaptez-vous au système de style du projet (Tailwind vs. CSS pur vs. CSS-in-JS) lors des corrections.
En révision, parcourez d'abord l'interface en mode clavier seul (chaque flux doit se terminer sans souris), puis en tant qu'utilisateur de lecteur d'écran : chaque contrôle annonce-t-il un nom, un rôle et son état ? En cas de doute, préférez le comportement par défaut de la plateforme à une reconstruction personnalisée, et retirez ARIA plutôt que d'en ajouter.
La mesure du contraste de paires rendues et la correction des couleurs sont couvertes par la compétence better-colors ; le dimensionnement visuel du texte et le zoom iOS par better-typography ; la mise en page RTL spatiale par better-layout.
Référence rapide
| Catégorie | Quand l'utiliser |
|---|---|
| Focus & Clavier | Anneaux de focus, liens d'évitement, tabindex, piège de focus, motifs clavier APG |
| Sémantique & ARIA | Éléments natifs d'abord, bouton vs lien, points de repère, noms accessibles, états désactivés |
| Formulaires | Labels, autocomplétion, messages d'erreur, types de champ |
| Lecteurs d'écran | Contenu masqué visuellement, régions live, toasts, texte alternatif, SVG |
| Zones de clic | Tailles de cibles, extension des zones de clic, règles de collision |
| Mouvement & Zoom | prefers-reduced-motion, lecture automatique et UI temporisé, zoom à 200%, réorganisation, rem vs px |
Principes fondamentaux
1. Éléments natifs d'abord
La première règle d'ARIA : n'utilisez pas ARIA lorsqu'un élément natif existe. <button> pour les actions, <a href> pour la navigation (il doit supporter les clics Cmd/Ctrl/milieu), jamais de <div onClick>. Pas d'ARIA vaut mieux qu'un mauvais ARIA.
2. Anneaux de focus visibles
Stylisez :focus-visible, pas le :focus nu, afin que les utilisateurs clavier obtiennent un anneau et les utilisateurs souris généralement non. Préférez l'indicateur de focus non modifié du navigateur. Si le design nécessite un anneau personnalisé, utilisez un jeton de focus du projet ou une autre couleur explicite et vérifiez l'indicateur complet contre chaque couleur adjacente qu'il traverse ; currentColor n'est acceptable qu'après la même vérification. Utilisez au moins un périmètre plein de 2px ou une zone visible équivalente. N'utilisez jamais outline: none sans un remplacement vérifié, et conservez les couleurs système en mode forced-colors.
3. Support clavier complet
Chaque interaction par pointeur nécessite un chemin clavier, suivant les motifs ARIA APG : Escape ferme les superpositions, les touches fléchées se déplacent dans les widgets composites (onglets, menus, listes), Tab se déplace entre les widgets, Entrée et Espace activent. Utilisez uniquement tabindex="0" (pour rejoindre l'ordre de tabulation naturel) et tabindex="-1" (focus programmatique), jamais de valeurs positives, qui cassent l'ordre naturel. Les widgets composites utilisent le roving tabindex : l'élément actif est 0, tous les autres -1.
4. Piéger et restaurer le focus
Les modales définissent inert sur le contenu de fond, déplacent le focus à l'intérieur à l'ouverture, et ramènent le focus au déclencheur à la fermeture. Ajoutez overscroll-behavior: contain pour que le contenu de fond ne défile pas.
5. Zone de clic minimale
Le niveau AA de la WCAG 2.5.8 est une cible de 24×24 pixels CSS ou l'une de ses exceptions définies (espacement, contrôle équivalent, en ligne, agent utilisateur, essentiel). Pour une activation plus facile, visez 44×44px dans les contextes tactiles et 40×40px dans les interfaces de bureau lorsque la densité le permet. Étendez avec un pseudo-élément si l'élément visible doit rester plus petit. Ne laissez jamais les zones de clic étendues se chevaucher.
6. Étiqueter et typer chaque contrôle
Chaque champ reçoit un <label for> ou un <label> englobant ; un placeholder n'est jamais un label, et le label et le contrôle partagent une seule zone de clic : pas de zones mortes entre une case à cocher et son texte. Ajoutez autocomplete avec un name pertinent, et le bon type et inputmode pour le clavier. Ne bloquez jamais le collage ; les utilisateurs collent des mots de passe et des codes à usage unique.
7. Erreurs qui s'annoncent
Gardez le bouton de soumission activé jusqu'au début de la requête, puis désactivez-le avec un spinner tout en conservant le label d'origine. Validez à la soumission : marquez les champs en échec avec aria-invalid="true", pointez aria-describedby vers le texte d'erreur en ligne, et placez le focus sur le premier champ invalide. Utilisez le disabled natif lorsqu'un contrôle natif est vraiment indisponible. Utilisez aria-disabled="true" uniquement lorsque la possibilité de focus ou la découvrabilité est intentionnelle ; bloquez alors le pointeur, le clavier et le comportement du formulaire dans le code et stylisez l'état explicitement.
8. Noms accessibles partout
Les boutons à icône seule nécessitent un aria-label descriptif. Le texte du label visible doit apparaître dans le nom accessible. Les éléments décoratifs reçoivent aria-hidden="true", jamais sur un élément focusable.
9. Ne pas se fier uniquement à la couleur
Le statut nécessite un indicateur redondant : icône, texte ou soulignement en plus de la couleur. Déterminez quelle exigence de contraste WCAG s'applique en fonction du contenu et de l'état, puis utilisez better-colors pour mesurer la paire de premier/arrière-plan rendue. Lorsque le contraste échoue, signalez la paire et l'exigence qu'elle ne respecte pas ; ne modifiez pas les couleurs du projet sans qu'on vous le demande.
10. Respecter prefers-reduced-motion
Encapsulez le mouvement dans @media (prefers-reduced-motion: no-preference) afin qu'il soit optionnel. En mouvement réduit, remplacez les glissements et les zooms par des fondus d'opacité ; supprimez complètement le parallaxe et la lecture automatique. Indépendamment de la préférence : les médias à lecture automatique nécessitent un contrôle de pause visible, et les toasts contenant des actions ou des erreurs restent jusqu'à ce qu'ils soient fermés.
11. Annoncer le contenu dynamique
Utilisez aria-describedby pour la validation propre à un champ, une région live polie (role="status") pour les mises à jour non urgentes non liées à un contrôle (comme les toasts ou les comptes de résultats), et role="alert" uniquement pour les erreurs urgentes non liées à un contrôle. Pour des annonces polies répétées fiables, rendez une région vide stable avant de mettre à jour son texte ; les alertes insérées dynamiquement ont un support différent et doivent être testées avec les lecteurs d'écran cibles.
12. Texte alternatif selon le but
Les images décoratives reçoivent alt="", les images informatives décrivent le sens, les images fonctionnelles décrivent l'action : un bouton avec icône de recherche est alt="Rechercher", pas alt="loupe".
13. La structure est la navigation
Utilisez des titres qui décrivent leurs sections et forment un plan cohérent ; un <h1> au niveau de la page et des niveaux correctement imbriqués sont la valeur par défaut recommandée, et non des règles WCAG isolées de succès/échec. Exposez un point de repère <main> visible et unique. Lorsque la navigation répétée ou le chrome le précède, faites d'un lien "Aller au contenu" le premier élément focusable. Les titres ancrés reçoivent scroll-margin-top.
14. Survivre au zoom et à la redimension du texte
La page doit fonctionner à un zoom de 200% et se réorganiser à une largeur de 320px sans défilement horizontal. Utilisez min-height au lieu de height fixe sur les conteneurs de texte, préférez les points de rupture en rem là où ils correspondent aux conventions du codebase, et conserver la balise viewport meta pour ne pas limiter la capacité de zoom du lecteur.
Erreurs courantes
| Erreur | Correction |
|---|---|
outline: none pour supprimer l'anneau de focus | Stylisez :focus-visible à la place ; les clics souris ne l'afficheront pas |
| Couleur de focus personnalisée supposée fonctionner partout | Vérifiez l'indicateur complet contre chaque couleur adjacente et en mode forced-colors |
<div onClick> pour un bouton ou un lien | <button> pour les actions, <a href> pour la navigation |
| Placeholder utilisé comme seul label | Ajoutez un <label for> visible ; les placeholders disparaissent à la saisie |
tabindex positif pour corriger l'ordre de focus | Corrigez l'ordre DOM ; utilisez uniquement 0 et -1 |
| Mise à jour polie répétée annoncée de manière incohérente | Conservez une région d'état vide stable et mettez à jour son texte ; testez les lecteurs d'écran cibles |
Région live assertive pour un toast de routine | Utilisez polie ; réservez assertive pour les erreurs |
aria-hidden="true" sur un élément focusable | Supprimez-le ou rendez l'élément non focusable |
| Le texte alt d'une icône fonctionnelle décrit l'image | Décrivez l'action : alt="Rechercher", pas alt="loupe" |
| Soumission désactivée jusqu'à ce que le formulaire soit valide | Gardez-la activée ; validez à la soumission et placez le focus sur la première erreur |
Format de sortie de révision
Utilisez ce format uniquement lorsque l'utilisateur demande une révision d'accessibilité autonome. Lorsque better-interface orchestre la révision, fournissez les preuves et les conclusions du domaine à cette compétence et laissez son format de sortie, son échelle de sévérité, ses règles de consolidation, son plafond et son verdict primer.
Présentez la révision autonome en deux parties.
Résultats
Regroupez tous les résultats confirmés par principe. Utilisez un tableau Markdown avec les colonnes Sévérité, Emplacement, Avant, Après et Pourquoi. N'utilisez jamais de lignes "Avant :" / "Après :" séparées.
- Sévérité :
ÉLEVÉEempêche une tâche, cache le contenu aux technologies d'assistance ou crée un échec d'accessibilité systémique ;MOYENNErend une interaction significativement plus difficile ;FAIBLEest un polissage isolé. - Emplacement : citez
chemin/vers/fichier:ligne. Si l'artefact n'a pas de fichiers source, citez l'écran et le composant exacts à la place. - Avant / Après : montrez l'implémentation actuelle et un remplacement opérationnel.
- Pourquoi : nommez le principe violé et son impact utilisateur.
Consolidez un problème systémique répété en une seule ligne et listez tous les emplacements affectés. Omettez les principes sans résultats.
Exemple
Noms accessibles partout
| Sévérité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| ÉLEVÉE | src/Dialog.tsx:42 | <button><XIcon /></button> | Ajouter aria-label="Fermer" ; marquer l'icône aria-hidden="true" | Le contrôle à icône seule n'a pas de nom accessible |
| ÉLEVÉE | src/Nav.tsx:18 | <a href="/settings"><GearIcon /></a> | Ajouter aria-label="Paramètres" | La destination du lien est indisponible pour les lecteurs d'écran |
Anneaux de focus visibles
| Sévérité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| ÉLEVÉE | src/button.css:12 | button:focus { outline: none; } | button:focus-visible { outline: 2px solid; outline-offset: 2px; } | Les utilisateurs clavier ne voient pas le focus |
| ÉLEVÉE | src/Menu.tsx:31 | focus:outline-none | focus-visible:outline-2 focus-visible:outline-offset-2 | La navigation dans le menu n'a pas d'indicateur de focus visible |
Erreurs qui s'annoncent
| Sévérité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| ÉLEVÉE | src/EmailField.tsx:27 | Erreur affichée uniquement avec border-red-500 | Ajouter aria-invalid="true" + aria-describedby="email-error" avec le texte d'erreur en ligne | La couleur seule n'explique ni n'annonce l'erreur |
| MOYENNE | src/SignupForm.tsx:64 | Soumission désactivée jusqu'à ce que le formulaire soit valide | Garder la soumission activée ; en cas d'échec, placer le focus sur le premier champ invalide | Une action désactivée cache ce qui doit être corrigé |
Zone de clic minimale
| Sévérité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| MOYENNE | src/Toolbar.tsx:22 | Bouton à icône size-4 | Étendre la zone de clic à 44×44px avec after:absolute after:size-11 | La cible est trop petite pour une saisie tactile fiable |
Vérification et verdict
Après les résultats :
- Vérification : listez les vérifications exactes effectuées et leurs résultats observés, y compris le parcours clavier, l'inspection du nom accessible, et les vérifications automatisées ou par lecteur d'écran lorsque applicable. Si une vérification n'a pas été effectuée, indiquez ce qui nécessite encore une vérification.
- Verdict :
Bloquantsi un résultatÉLEVÉEsubsiste,Modifications nécessairessi seuls des résultatsMOYENNEouFAIBLEsubsistent, etApprouvéuniquement lorsqu'aucun résultat actionnable ne subsiste.
Lorsqu'il n'y a aucun résultat, omettez les tableaux, indiquez "Aucun résultat d'accessibilité actionnable", rapportez la vérification, et terminez par Approuvé.