Cet article explique comment repérer et corriger les défauts d’accessibilité qu’une machine sait reconnaître : dans l’éditeur, sur la page servie et dans le contraste de vos couleurs. Vous saurez aussi ce que ces outils ne vérifient pas.
Avant de commencer
Trois outils signalent les défauts d’accessibilité qu’une machine sait reconnaître. Chacun se trouve là où la correction coûte le moins.
| Outil | Où | Objet vérifié |
|---|---|---|
| Le panneau Accessibilité | Dans l’éditeur, depuis la barre d’outils | Vos blocs pendant que vous les écrivez, puis la page entourée de son gabarit. |
| Le badge | Sur votre site, en bas à gauche, quand vous y naviguez connecté | La page telle qu’un visiteur la reçoit, en-tête et pied de page compris. |
| Le verdict de contraste | Sous les couleurs d’un bloc, dans l’onglet Styles | La couleur du texte contre la couleur du fond du bloc. |
Aucun constat n’empêche d’enregistrer ou de publier, pas même une erreur. Aucun de ces outils ne donne de taux ni ne déclare une page conforme.
Vérifier une page dans l’éditeur
- Ouvrez la page dans l’éditeur.
- Regardez l’icône Accessibilité de la barre d’outils. Une pastille rouge compte les erreurs, une pastille orange les points à revoir. Au-delà de neuf, elle affiche 9+.
- Cliquez sur l’icône. Le panneau Accessibilité s’ouvre sur la section Contrôles automatiques.
- Lisez chaque constat. Il commence par le numéro du critère RGAA concerné.
- Cliquez sur Afficher le bloc sous le constat. Le bloc en cause est sélectionné.
- Corrigez le bloc. Le constat disparaît du panneau.

Le panneau s’ouvre aussi par le menu ⋮ en haut à droite, puis Accessibilité. Il se met à jour pendant que vous modifiez la page. Une ligne en tête compte les points, par exemple Une erreur à corriger. Sans constat, il affiche Rien à signaler sur les contrôles qu’une machine peut trancher.

| Niveau | Couleur | Signification |
|---|---|---|
| Erreur | Rouge | Un défaut avéré. Dans cette situation, aucun cas n’est correct. |
| Avertissement | Orange | Un point que vous seul pouvez trancher. Une vidéo sans parole n’a pas besoin de sous-titres. |
Lire les contrôles du panneau
Sur le contenu que vous écrivez
| Critère | Constat | Niveau |
|---|---|---|
| 9.1 | Les titres dans le désordre : une page qui ne commence pas par un titre de niveau 1, plusieurs titres de niveau 1 ou un niveau sauté. | Erreur |
| 1.1 | Une image sans texte alternatif, sauf si elle est marquée Image décorative. Une vidéo n’est jamais signalée à ce critère. | Erreur |
| 4.3 | Une vidéo en lecture Manuelle sans piste de sous-titres. | Avertissement |
| 4.3 | Une vidéo sans lecteur (En boucle tant qu’elle est visible, Au survol ou Suit le défilement) qui porte des pistes de texte : personne ne peut les ouvrir. | Avertissement |
| 13.8 | Une vidéo réglée sur Une seule fois, à l’apparition : elle démarre seule et ne peut pas être arrêtée. | Avertissement |
| 13.8 | Une vidéo En boucle tant qu’elle est visible ou Au survol, un diaporama ou des onglets qui tournent seuls, dont Afficher un bouton de pause est désactivé. | Avertissement |
| 2.2 | Un embed ou un PDF sans Titre (accessibilité). Il s’annonce alors Contenu intégré ou Document PDF, ce qui ne dit rien de son contenu. | Avertissement |
| 6.1 | Un bouton sans texte visible ni Nom accessible. | Erreur |
| 11.1 | Un champ de formulaire dont le libellé est masqué et vide. | Erreur |
Seule une piste de sous-titres lève l’avertissement 4.3. Une piste d’audiodescription seule ne le lève pas.
Un titre réglé sur Rendre comme un élément non titré sort du plan de la page : le contrôle 9.1 ne le compte pas.
Sur la page entourée de son gabarit
Ces contrôles regardent la page avec l’en-tête, les menus et le pied de page de son gabarit. Ils se corrigent dans le gabarit et n’ont pas de lien Afficher le bloc.
| Critère | Constat | Niveau |
|---|---|---|
| 12.6 | Aucune zone de contenu principal. Réglez un conteneur du gabarit sur la balise main. | Erreur |
| 12.6 | Plusieurs zones de contenu principal. | Erreur |
| 12.6 | Plusieurs zones de navigation dont une sans Nom de la région. | Avertissement |
Corriger les constats courants
Décrire une image
- Cliquez sur Afficher le bloc sous le constat 1.1. Le bloc Média est sélectionné.
- Dans l’onglet Réglages, panneau Média, remplissez le Texte alternatif avec ce que l’image montre.
- Si l’image n’apporte aucune information, activez plutôt Image décorative.

Nommer un champ sans libellé visible
Un champ de recherche dans un en-tête se passe souvent de libellé visible. Écrivez le libellé, puis désactivez Afficher le libellé. Le libellé reste lu par les lecteurs d’écran et le constat 11.1 disparaît.
Distinguer deux menus
Quand une page porte deux zones de navigation, sélectionnez le conteneur du second menu dans le gabarit et remplissez Nom de la région, par exemple « Menu du pied de page ». L’avertissement disparaît.
Laisser un avertissement en l’état
Un avertissement peut rester si vous jugez qu’il n’y a rien à corriger. Une vidéo d’ambiance sans parole garde son avertissement 4.3, qui ne bloque rien. Une vidéo réglée sur Une seule fois, à l’apparition reste acceptable si elle dure moins de cinq secondes et n’a pas de son. Son contenu doit aussi figurer en texte dans la page. Sinon, repassez sa lecture sur Manuelle.
Vérifier la page servie avec le badge
- Connectez-vous à l’administration de votre site.
- Ouvrez la page sur votre site.
- En bas à gauche, lisez le badge, par exemple Accessibilité : 2 à corriger.
- Dépliez le badge. Chaque ligne donne le critère, le constat et, quand il vise un élément, un repère pour le retrouver : sa balise, son identifiant ou ses classes.
| La page porte | Le badge affiche |
|---|---|
| Des erreurs seules | Accessibilité : 2 à corriger |
| Des avertissements seuls | Accessibilité : 1 à regarder |
| Les deux | Accessibilité : 2 à corriger, 1 à regarder |
Une page sans constat n’affiche pas de badge. Le badge ne s’affiche qu’aux personnes connectées qui peuvent modifier les contenus : vos visiteurs ne le voient jamais.
Le badge lit la page complète, telle que le serveur l’envoie : la langue déclarée, l’en-tête et le pied de page, les listes de contenus et les formulaires une fois remplis, les liens tels qu’ils sont écrits dans la page. Il trouve donc des défauts que l’éditeur ne voit pas.
| Critère | Constat | Niveau |
|---|---|---|
| 1.1 | Une image sans alternative textuelle ni déclaration décorative. | Erreur |
| 5.4 | Un tableau sans titre. | Avertissement |
| 5.6 | Un tableau sans cellule d’en-tête. | Erreur |
| 6.1 | Un lien ou un bouton sans aucun texte. | Erreur |
| 7.3 | Un élément qui s’annonce comme un contrôle mais que le clavier n’atteint pas. | Erreur |
| 8.2 | Un même identifiant porté par deux éléments. Une ancre et un lien qui le visent atteignent le premier. | Erreur |
| 8.3 | Une langue déclarée différente de celle de l’adresse de la page. | Erreur |
| 9.1 | Aucun titre de niveau 1, plusieurs, un niveau sauté, ou un titre vide. | Erreur |
| 11.1 | Un champ que rien ne nomme, ou une liaison vers un identifiant absent de la page. | Erreur |
| 12.6 | Aucune zone de contenu principal ou plusieurs (erreur), des zones de même nature qu’on ne distingue pas (avertissement). | Erreur ou avertissement |
| 12.7 | Le lien d’évitement mène à une ancre absente de la page. | Erreur |
Sur la page servie, le premier titre peut appartenir à l’en-tête du site. Le badge vérifie donc qu’il y a un seul titre de niveau 1 et aucun niveau sauté. Il ne vérifie pas que ce titre vient en premier.
Vérifier le contraste de vos couleurs
- Sélectionnez un bloc et ouvrez l’onglet Styles, panneau Couleurs.
- Choisissez une couleur de texte et une couleur de fond.
- Lisez le verdict sous le sélecteur, par exemple Contraste 4.7:1. Lisible (AA).

| Rapport | Verdict | Usage |
|---|---|---|
| Moins de 3:1 | Trop faible. Le texte sera difficile à lire sur cette couleur. | Insuffisant dans tous les cas. |
| De 3:1 à 4,5:1 | Grand texte seulement (AA). | Un texte d’environ 24 px (18,7 px en gras) ou un élément d’interface. |
| De 4,5:1 à 7:1 | Lisible (AA). | Le niveau attendu pour un texte courant. |
| 7:1 et plus | Très lisible (AAA). | Le niveau renforcé. |
Seuls les verdicts à revoir sont en couleur : rouge pour un contraste trop faible, orangé pour un contraste réservé au grand texte. Quand le bloc a des couleurs propres au mode sombre, deux verdicts s’affichent, précédés de Mode clair : et Mode sombre :. Un site qui n’a qu’un mode n’en montre qu’un.
| Situation | Raison |
|---|---|
| L’une des couleurs est un dégradé | Un dégradé n’a pas une couleur unique à comparer. |
| L’une des couleurs est transparente | Le résultat dépend de ce qui se trouve derrière. |
| Ni le bloc ni son style enregistré n’ont de couleur de fond | Le texte se lit sur le fond du bloc parent, que le panneau ne voit pas. Posez un fond plein sur le bloc pour obtenir un verdict. |
La couleur des liens n’entre pas dans le calcul, ni une image ou une vidéo d’arrière-plan. Pour un texte posé sur une image, regardez le résultat sur la page.
Compter sur les composants livrés
Une part de l’accessibilité est faite dans les blocs eux-mêmes, sans réglage de votre part.
| Composant | Prise en charge |
|---|---|
| Toutes les pages | Un anneau de focus visible au clavier, un lien Aller au contenu en tête de page, un titre, une langue déclarée et un zoom jamais bloqué. |
| Onglets | Navigation aux flèches gauche et droite, un seul arrêt de tabulation pour toute la barre, panneaux fermés retirés de la page, onglet actif marqué par un trait et une couleur. |
| Menus déroulants | Ouverture au clavier, fermeture par Échap avec retour du focus, état ouvert ou fermé annoncé. |
| Diaporama et carrousel | Flèches activables au clavier, diapositives masquées retirées de la page, flèche en bout de course annoncée comme désactivée. |
| Modales et panneaux latéraux | La fenêtre garde le focus, met la page du dessous en sommeil, se ferme par Échap et rend le focus au déclencheur. Voir Ouvrir une modale ou un panneau latéral. |
| Champs de formulaire | Libellé, description et aide reliés au champ, même avec un libellé masqué. Le message d’erreur s’ajoute à la description. |
| Menu burger | Un vrai lien, atteint par Tab, ouvert par Entrée et annoncé Ouvrir le menu. |
Connaître les limites de ces outils
Le RGAA compte 106 critères, déclinés en 258 tests. Une machine n’en tranche qu’une petite partie, ce qui se constate dans le code de la page. Ces outils ne jugent pas :
- si un texte alternatif décrit vraiment l’image ;
- si l’intitulé d’un lien a du sens hors de son contexte ;
- si des sous-titres sont justes, complets et synchronisés ;
- si le libellé d’un champ se comprend ;
- si un texte posé sur une image, sur un dégradé ou sur le fond d’un bloc parent reste lisible ;
- si toute la page se parcourt au clavier dans le bon ordre.
Chaque page se vérifie à part : le panneau examine la page ouverte dans l’éditeur, le badge celle que vous visitez. Parcourir votre site connecté est la façon la plus rapide d’en faire le tour.