Accessibilité web : les bases, tirées d’audits réels
Les bases de l’accessibilité web, illustrées par ce que les audits de deux sites en production ont réellement trouvé et corrigé : éléments cliquables, focus, formulaires, vidéo d’accueil, toasts, puis les tests qui évitent que ces défauts reviennent.
J’ai conçu le site de l’association Amae Production en 2024. En 2026, je lui ai proposé une remise à niveau, qu’elle a acceptée : montée vers Next.js 16, puis un audit complet suivi de corrections par lots. Cet article reprend les bases de l’accessibilité web à partir de ce que cet audit a réellement trouvé, complété par ceux du site Les Chemins de la Maison et par les tests automatisés de mon socle de sites vitrines. Il s’adresse aux développeurs qui se demandent par où commencer. Ce n’est pas un audit de conformité RGAA, et l’article dit aussi ce que ces vérifications ne couvrent pas.
Quelles règles servent de référence ?
La référence internationale est le WCAG (Web Content Accessibility Guidelines), dans sa version 2.2, dont le niveau AA est celui généralement visé. En France, le RGAA (Référentiel général d’amélioration de l’accessibilité) traduit les critères du WCAG 2.1 en tests ; la version en vigueur est la 4.1.2, et la DINUM annonce une version 5 pour la fin 2026. Depuis le 28 juin 2025, l’European Accessibility Act étend aussi des exigences d’accessibilité à certains services privés, comme le commerce en ligne, dont sont exemptées les microentreprises qui fournissent ces services.
Ces textes ne s’appliquent pas à tous les sites de la même façon. Ils restent pourtant la grille la plus utile pour savoir quoi vérifier, et la plupart de leurs critères se jouent dans le code, au moment où l’on choisit une balise, où l’on stylise un état ou où l’on décide de ce que devient le focus après un clic.
Comment s’est déroulé l’audit ?
L’audit du site d’Amae a eu lieu le 7 octobre 2026, sur le build Next.js 16. Je l’ai mené avec Claude Code, en combinant un audit d’avant mise en production et des agents de revue spécialisés (SEO, accessibilité, performance), tous en lecture seule. Rien n’a été corrigé pendant l’audit, de sorte que le constat reste complet et que chaque correction peut être vérifiée à part.
Les constats ont ensuite été regroupés en lots par priorité, bloquante, importante ou mineure, et traités un par un avec la même vérification à chaque fois (lint, typage, build). Le lot accessibilité comptait 23 points, dont 2 bloquants. Il s’est terminé par une navigation complète au clavier sur les quatre pages du site.
Un agent lit le code et le HTML généré ; il n’entend pas ce que prononce un lecteur d’écran. Cette écoute, avec NVDA sous Windows ou VoiceOver sous macOS, reste une étape à faire soi-même, et c’est la suivante prévue pour ce site.
Pourquoi un div cliquable ne suffit-il pas ?
Les deux points bloquants avaient la même cause. Les catégories de la page des réalisations et les vignettes vidéo étaient des div rendus cliquables en JavaScript : impossibles à atteindre avec Tab, annoncés comme du simple texte et insensibles à Entrée ou Espace. Un button apporte tout cela nativement, ce qu’aucun attribut ajouté à un div ne fait à lui seul.
Pour les catégories, le pattern d’onglets ARIA (tablist, aria-selected) semblait le choix évident. Il suppose pourtant un panneau par onglet et une navigation aux flèches, alors qu’ici les catégories filtrent une seule liste. J’ai donc retenu des boutons à bascule regroupés dans un groupe nommé, qui décrivent exactement ce comportement et fonctionnent au clavier sans code supplémentaire :
// Simplified example
<div role="group" aria-label="Filtrer les réalisations">
{categories.map((category) => (
<button
key={category.id}
type="button"
aria-pressed={category.id === active}
onClick={() => setActive(category.id)}
>
{category.label}
</button>
))}
</div>C’est la première règle d’ARIA (Accessible Rich Internet Applications) : ne pas s’en servir quand un élément natif suffit, et sinon choisir le motif qui correspond au comportement réel. Les filtres de la page du blog suivent le même principe, avec en plus le nombre d’articles affichés dans une zone role="status", lue après chaque changement.
Comment un lecteur d’écran s’oriente-t-il dans la page ?
Un lecteur d’écran permet de passer d’une zone à l’autre (en-tête, navigation, contenu principal) ou de titre en titre, à condition que la page les déclare. Deux pages d’Amae n’avaient pas de main, et l’en-tête n’était pas un header. Les titres h1 et h2 de l’accueil étaient masqués avec display:none, ce qui les retire aussi des technologies d’assistance ; une classe qui les cache seulement à l’écran les rend de nouveau lisibles. Un lien d’évitement « Aller au contenu », premier élément atteint avec Tab, permet en outre de sauter le menu.
L’audit a aussi trouvé des liens sans nom, comme une flèche vers les réalisations faite d’une seule icône SVG. Un aria-label sur le lien et aria-hidden sur l’icône suffisent à la rendre compréhensible.
Où le focus doit-il aller après une action ?
Le focus, c’est-à-dire l’indicateur de l’élément actif au clavier, doit d’abord rester visible. L’audit a relevé trois cas sur Amae : les champs du formulaire avaient perdu leur contour sans remplacement, les flèches et les points du carrousel n’affichaient aucun focus, et le bouton principal en affichait un qui rendait son texte presque illisible, avec un contraste de 1,87:1 là où les WCAG demandent 4,5:1 pour du texte. La correction est la même partout, un outline net sur :focus-visible, qui n’apparaît qu’à la navigation au clavier.
Il doit ensuite arriver au bon endroit. Lorsqu’un élément disparaît ou qu’une action se termine, le navigateur renvoie souvent le focus sur body, en haut de la page, et l’utilisateur au clavier perd sa position. Sur Amae, c’était le cas après la fermeture d’un toast au clavier (un toast est le petit message de confirmation ou d’erreur qui s’affiche en surimpression), et pendant l’envoi du formulaire, parce que les champs passés en disabled perdaient le focus. Les champs sont désormais en lecture seule pendant l’envoi, le bouton en aria-disabled, et le focus revient sur le premier champ après un envoi réussi. À l’inverse, ouvrir une vidéo déplace volontairement le focus sur le lecteur.
Le WCAG 2.2 ajoute une exigence liée : l’élément qui a le focus ne doit pas être entièrement masqué, par exemple par un en-tête fixe. C’est justement le dernier point du lot, un contrôle à l’écran qui ne se vérifie pas dans le code.
Comment rendre un formulaire utilisable sans voir l’écran ?
Un message d’erreur affiché sous un champ n’existe pas pour un lecteur d’écran tant qu’il n’est pas relié à ce champ. Sur le formulaire de contact d’Amae, chaque erreur, aide ou compteur a maintenant un identifiant référencé par aria-describedby, et le champ fautif porte aria-invalid :
// Simplified example
<input
id={name}
required
aria-invalid={Boolean(error)}
aria-describedby={error ? `${name}-message` : undefined}
/>
{error && <p id={`${name}-message`}>{error.message}</p>}Le reste a demandé plus d’attention. Les champs obligatoires sont exposés par l’attribut required natif, avec noValidate sur le formulaire pour laisser la validation à l’application, et une phrase visible indique que tous les champs sont requis. React Hook Form déplace le focus sur le premier champ invalide avant que son message ne soit rendu, si bien qu’un lecteur d’écran ne le lisait pas : un résumé du type « 2 champs à corriger. » est donc annoncé à l’envoi. Le compteur « 0 / 600 » était lu sans unité, il est complété par « caractères » dans un texte réservé aux lecteurs d’écran. Enfin, le rouge des messages d’erreur atteignait 4,11:1, un peu sous le seuil de 4,5:1, et a été éclairci.
Une vidéo d’accueil en lecture automatique pose-t-elle problème ?
Le critère 2.2.2 des WCAG demande qu’un contenu en mouvement, lancé automatiquement et qui dure plus de cinq secondes, puisse être mis en pause. La vidéo plein écran de l’accueil d’Amae n’en offrait pas la possibilité. Elle est désormais dotée d’un bouton pause discret, ne démarre pas quand le visiteur a activé la préférence de réduction des animations de son système (prefers-reduced-motion), et reste masquée aux lecteurs d’écran puisqu’elle est décorative.
La même préférence s’applique aux animations Framer Motion via MotionConfig. Un cas demandait une exception : la fermeture automatique des toasts suivait la fin de leur barre de progression animée. Rendre toutes les animations instantanées aurait fermé les toasts dès leur apparition, si bien que cette animation-là n’est pas concernée par la préférence. Sur ce portfolio, les animations GSAP suivent la même préférence, comme le détaille l’article sur GSAP.
Quels défauts reviennent d’un projet à l’autre ?
En comparant les audits d’Amae et ceux du site Les Chemins de la Maison, menés à quelques jours d’intervalle, les toasts sortent nettement du lot. Sur Amae, ils n’étaient pas annoncés aux lecteurs d’écran, faute d’un conteneur role="status" monté en permanence. Sur Les Chemins, le thème coloré de react-toastify donnait au toast d’erreur un contraste de 3,82:1, et le message disparaissait au bout de sept secondes avec une pause au survol, mais pas au clavier, ce qui pose problème au regard du critère 2.2.1 sur les délais. Il reste désormais affiché jusqu’à sa fermeture, qui se fait aussi au clavier.
Les menus déroulants sont le deuxième point récurrent. Sur Les Chemins, la touche Échap ne refermait pas le menu des services sur ordinateur, alors que c’est le premier réflexe d’un utilisateur au clavier. Ces composants viennent souvent d’une librairie, dont les réglages par défaut ne garantissent pas l’accessibilité. Ce sont donc les premiers que je vérifie sur un nouveau projet.
Comment éviter que ces défauts reviennent ?
Sur mon socle de sites vitrines, un test Playwright parcourt toutes les routes du site et les soumet à axe-core, le moteur d’analyse de Deque également utilisé par Lighthouse. Le test échoue dès qu’une violation sérieuse ou critique apparaît sur les règles WCAG 2.0 et 2.1 de niveaux A et AA, et un second test vérifie au clavier que le lien d’évitement mène bien au contenu. Les deux tournent en intégration continue, sur le build de production. Les règles propres au WCAG 2.2 n’y figurent pas encore, ce qui reste à ajouter.
En amont, les quelques règles jsx-a11y d’ESLint activées par eslint-config-next signalent dès l’écriture une image sans alt ou un attribut ARIA invalide ; un div rendu cliquable leur échappe, sauf à activer d’autres règles du plugin. Ces outils ont leurs limites. Ils repèrent une image sans alt, mais pas un alt qui décrit mal l’image, ni un ordre de lecture déroutant, ni un focus qui part au mauvais endroit après une action, c’est-à-dire une bonne partie des corrections décrites plus haut. La place de ces contrôles dans une stratégie de tests plus large est détaillée dans l’article sur les tests React.