Se connecter Demander mon site

Vérifier l’accessibilité de vos pages

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.

Les trois outils
OutilOùObjet vérifié
Le panneau AccessibilitéDans l’éditeur, depuis la barre d’outilsVos blocs pendant que vous les écrivez, puis la page entourée de son gabarit.
Le badgeSur 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 contrasteSous les couleurs d’un bloc, dans l’onglet StylesLa 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

  1. Ouvrez la page dans l’éditeur.
  2. 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+.
  3. Cliquez sur l’icône. Le panneau Accessibilité s’ouvre sur la section Contrôles automatiques.
  4. Lisez chaque constat. Il commence par le numéro du critère RGAA concerné.
  5. Cliquez sur Afficher le bloc sous le constat. Le bloc en cause est sélectionné.
  6. Corrigez le bloc. Le constat disparaît du panneau.
L’icône Accessibilité de la barre d’outils de l’éditeur, avec une pastille rouge 1 en haut et une pastille orange 1 en bas.

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.

Le panneau Accessibilité : la ligne Une erreur à corriger, le constat 9.1 sur un titre de niveau 4 placé après un niveau 2, le lien Afficher le bloc, puis le rappel que rien n’empêche de publier.
Les deux niveaux d’un constat
NiveauCouleurSignification
ErreurRougeUn défaut avéré. Dans cette situation, aucun cas n’est correct.
AvertissementOrangeUn 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

Les contrôles sur votre contenu
CritèreConstatNiveau
9.1Les 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.1Une 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.3Une vidéo en lecture Manuelle sans piste de sous-titres.Avertissement
4.3Une 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.8Une 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.8Une 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.2Un 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.1Un bouton sans texte visible ni Nom accessible.Erreur
11.1Un 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.

Les contrôles sur la page assemblée
CritèreConstatNiveau
12.6Aucune zone de contenu principal. Réglez un conteneur du gabarit sur la balise main.Erreur
12.6Plusieurs zones de contenu principal.Erreur
12.6Plusieurs zones de navigation dont une sans Nom de la région.Avertissement

Corriger les constats courants

Décrire une image

  1. Cliquez sur Afficher le bloc sous le constat 1.1. Le bloc Média est sélectionné.
  2. Dans l’onglet Réglages, panneau Média, remplissez le Texte alternatif avec ce que l’image montre.
  3. Si l’image n’apporte aucune information, activez plutôt Image décorative.
Le panneau Média d’une photo : l’interrupteur Image décorative et sa définition, le texte alternatif qui décrit les rangs de vignes du Clos Vermeil au printemps, puis la taille maximale.

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

  1. Connectez-vous à l’administration de votre site.
  2. Ouvrez la page sur votre site.
  3. En bas à gauche, lisez le badge, par exemple Accessibilité : 2 à corriger.
  4. 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.
Le résumé du badge
La page porteLe badge affiche
Des erreurs seulesAccessibilité : 2 à corriger
Des avertissements seulsAccessibilité : 1 à regarder
Les deuxAccessibilité : 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.

Les contrôles du badge
CritèreConstatNiveau
1.1Une image sans alternative textuelle ni déclaration décorative.Erreur
5.4Un tableau sans titre.Avertissement
5.6Un tableau sans cellule d’en-tête.Erreur
6.1Un lien ou un bouton sans aucun texte.Erreur
7.3Un élément qui s’annonce comme un contrôle mais que le clavier n’atteint pas.Erreur
8.2Un même identifiant porté par deux éléments. Une ancre et un lien qui le visent atteignent le premier.Erreur
8.3Une langue déclarée différente de celle de l’adresse de la page.Erreur
9.1Aucun titre de niveau 1, plusieurs, un niveau sauté, ou un titre vide.Erreur
11.1Un champ que rien ne nomme, ou une liaison vers un identifiant absent de la page.Erreur
12.6Aucune zone de contenu principal ou plusieurs (erreur), des zones de même nature qu’on ne distingue pas (avertissement).Erreur ou avertissement
12.7Le 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

  1. Sélectionnez un bloc et ouvrez l’onglet Styles, panneau Couleurs.
  2. Choisissez une couleur de texte et une couleur de fond.
  3. Lisez le verdict sous le sélecteur, par exemple Contraste 4.7:1. Lisible (AA).
Le sélecteur de couleur d’un bloc sur un vert foncé, avec le verdict Contraste 7.1:1. Très lisible (AAA), puis l’interrupteur Ajouter une valeur pour le mode sombre.
Les verdicts de contraste
RapportVerdictUsage
Moins de 3:1Trop faible. Le texte sera difficile à lire sur cette couleur.Insuffisant dans tous les cas.
De 3:1 à 4,5:1Grand 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:1Lisible (AA).Le niveau attendu pour un texte courant.
7:1 et plusTrè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.

Les cas sans verdict
SituationRaison
L’une des couleurs est un dégradéUn dégradé n’a pas une couleur unique à comparer.
L’une des couleurs est transparenteLe résultat dépend de ce qui se trouve derrière.
Ni le bloc ni son style enregistré n’ont de couleur de fondLe 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.

Les composants livrés accessibles
ComposantPrise en charge
Toutes les pagesUn 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é.
OngletsNavigation 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éroulantsOuverture au clavier, fermeture par Échap avec retour du focus, état ouvert ou fermé annoncé.
Diaporama et carrouselFlè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érauxLa 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 formulaireLibellé, description et aide reliés au champ, même avec un libellé masqué. Le message d’erreur s’ajoute à la description.
Menu burgerUn 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.

Voir aussi

Mis à jour le

Toutes les pages de la documentation