Tester

Audit RGAA d'un site WordPress : d'où vient chaque défaut, et qui le corrige

7 min de lecture
Mikhail ShaymardanovExpert en Qualité et Accessibilité Web

La rédaction du client corrige elle-même, dans la médiathèque et l'éditeur de WordPress, une partie des défauts d'un audit RGAA. Une image sans texte alternatif ou un paragraphe trop pâle reste là où la rédaction l'a publié, alors qu'un défaut d'un modèle du thème se répète sur chaque page bâtie avec lui. Le code de la page désigne en général la source de chaque défaut, donc qui le corrige.

Des pages auditées aux corrections qui tiennent


#Quelles pages d'un site WordPress mettre dans un audit RGAA ?

Un audit RGAA porte sur un échantillon de pages. L'auditeur y vérifie les 106 critères du RGAA, le référentiel français d'accessibilité, par exemple qu'un texte agrandi au double reste lisible.

La règle officielle impose sept pages quand elles existent, dont l'accueil, le contact et la page « accessibilité ». Elle ajoute au moins une page par type de service ou autre usage principal, recherche comprise, et un document téléchargeable par service le cas échéant. Elle exige aussi toutes les pages d'un processus, comme une réservation. Elle demande enfin des pages d'aspect ou de contenu différent, puis des pages tirées au hasard, au moins 10 % de l'échantillon.

Sur WordPress, chaque type de page sort d'un modèle, le squelette fourni par le thème (les auditeurs disent un gabarit), et un défaut du modèle se répète sur toutes ses pages. Les modèles qu'ajoute une extension figurent aussi dans l'éditeur de site, et leurs pages ont leur place dans l'échantillon.

Notre démo, l'Office de tourisme de Port-Marzelle, est un établissement public, que la loi oblige à rendre son site accessible. Ses treize pages d'échantillon sortent de cinq modèles.

Capture d'écran : la liste des modèles du thème Littoral dans l'éditeur de site de WordPress, de « Index » à « Toutes les archives », chacun avec sa description.Repère 1. Le modèle « Pages » du thème Littoral, qui sert à sept des treize pages de l'échantillon.
Dans Apparence > Éditeur > Modèles, le thème Littoral fournit les modèles de l'échantillon, et sept des treize pages sortent du seul modèle « Pages »repère 1.
L'échantillon de Port-Marzelle : treize pages, cinq modèles
ModèlePages de l'échantillon
Page d'accueilAccueil
PagesContact
Mentions légales
Accessibilité
Plan du site
Choisir une visite
Vos coordonnées
Les marais salants
Publications seulesFête de la sardine
Marché du sel (au hasard)
Nuit des étoiles (au hasard)
Toutes les archivesAgenda
Résultats de rechercheRecherche « marais »
Audit d'accessibilité d'un site web : prix, devis et choix de l'auditeur

#Comment savoir d'où vient un défaut RGAA sur WordPress ?

Le code de la page désigne en général la source d'un défaut. Un test la confirme sur une copie de préproduction, un double du site où l'on teste sans toucher au site public.

#Le même défaut sur chaque page : un modèle du thème

Sur l'accueil de Port-Marzelle, il faut sept appuis sur Tab pour atteindre « Choisir une visite », le premier lien du contenu. Faute de lien d'évitement (un lien « Aller au contenu » qui saute le menu), quiconque se déplace au clavier refait ce trajet à chaque page. Le rapport range ce défaut au critère 12.7, et nos treize pages y échouent.

Cliquez sur la démo, puis appuyez sur la touche indiquée, ou avancez avec « Étape suivante ». Échap fait sortir de la démo.
7 étapes

Sur l'accueil de Port-Marzelle, le focus passe par le titre, les quatre liens du menu et « Réserver » : le contenu ne commence qu'au septième Tab, sur « Choisir une visite ».

WordPress sait pourtant poser ce lien tout seul. Sur un thème de blocs, il l'ajoute dès que le modèle contient un élément <main>, la balise du contenu principal, absente de l'accueil. Sous Twenty Twenty-Five, thème par défaut étiqueté « accessibility-ready », notre copie affiche « Aller au contenu » dès le premier Tab. Le défaut vient donc des modèles de Littoral, le thème acheté pour Port-Marzelle : l'agence le corrige.

Ajouter un lien d'évitement : le code HTML et le test au clavier

#Une classe qui porte le nom de l'extension

Sur « Choisir une visite », les trois champs de réservation n'ont qu'un texte indicatif, « Courriel » par exemple, et aucune étiquette. L'étiquette est le nom relié au champ dans le code, celui qu'il faut par exemple à une personne qui utilise un lecteur d'écran (critère 11.1).

La classe du bloc donne la piste : après wp-block-, WordPress écrit le nom de l'extension, ou du thème, qui a déclaré le bloc. Un bloc fourni par WordPress n'en porte aucun. Ici, la classe nomme Résa Escale, dont le script arrive de /wp-content/plugins/resa-escale/. Un développeur peut renommer cette classe, d'où notre test sous Twenty Twenty-Five, Résa Escale active : les champs restent sans étiquette, donc le code vient de l'extension.

Capture d'écran : le panneau Éléments de DevTools ouvert sur la page « Choisir une visite », le premier champ du formulaire de réservation sélectionné.Repère 1. La balise du bloc, dont la classe wp-block-resa-escale-reservation nomme l'extension Résa Escale. Repère 2. Le premier champ du formulaire, avec son seul texte indicatif « Date de la visite (jj/mm/aaaa) ».
Dans le panneau Éléments de DevTools, la classe du bloc nomme l'extension Résa Escalerepère 1, et le champ de date n'a que son texte indicatif, sans étiquette devant luirepère 2.

#Un défaut sur une seule page : le contenu saisi

Sur « Fête de la sardine », l'affiche, un bloc Image de WordPress, a un texte alternatif vide (critère 1.1). Ce texte se lit à la place de l'image quand on ne la voit pas, et seule l'affiche donne la date et le lieu de la fête.

Sur « Les marais salants », la classe has-gris-perle-color d'un paragraphe trahit une couleur choisie dans les réglages du bloc. Ce gris donne 2,11:1 sur le blanc, trop pâle pour une personne qui a une vue basse (les seuils de contraste, critère 3.2). Une telle classe peut aussi venir d'un modèle, or ni ce gris ni ce texte alternatif vide ne reviennent sur les autres pages des mêmes modèles. La rédaction les corrige donc.


#Qui corrige chaque défaut du rapport d'audit, et où ?

L'agence corrige le modèle une fois, dans un thème enfant. L'extension se corrige par ses réglages, un filtre ou chez son éditeur, celui qui la publie. La rédaction corrige ses pages.

#Le modèle du thème : une fois, dans le thème enfant

Le correctif tient en un attribut : le bloc Groupe du contenu devient <main>, par « Élément HTML » (section « Avancé ») ou par "tagName":"main" dans le fichier du modèle. Sur la démo, les treize pages ont reçu le lien d'évitement une fois les six modèles de Littoral corrigés.

Ces fichiers vont dans un thème enfant, qui hérite de Littoral : un fichier au nom d'un modèle de Littoral le remplace, et Littoral garde ses mises à jour. Sur un thème classique, le lien vient du thème, et se corrige aussi dans un thème enfant.

À éviter

Capture d'écran : l'en-tête de Port-Marzelle, le contour de focus bleu nuit autour du titre « Port-Marzelle ».Repère 1. Le titre « Port-Marzelle », qui reçoit le focus au premier appui sur Tab.
<!-- wp:group {"layout":{"type":"constrained"}} -->
<div class="wp-block-group">
  <!-- wp:post-title {"level":1} /-->
  <!-- wp:post-content {"layout":{"type":"constrained"}} /-->
</div>
<!-- /wp:group -->

Correct

Capture d'écran : le lien « Aller au contenu », gris clair, posé en haut à gauche de l'en-tête de Port-Marzelle et entouré du contour de focus.Repère 1. Le lien « Aller au contenu » que WordPress ajoute, affiché au premier appui sur Tab.
<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
<main class="wp-block-group">
  <!-- wp:post-title {"level":1} /-->
  <!-- wp:post-content {"layout":{"type":"constrained"}} /-->
</main>
<!-- /wp:group -->
Au premier Tab, le modèle de Littoral envoie le focus sur le titre « Port-Marzelle »repère 1 ; avec l'élément main dans le modèle du thème enfant, WordPress affiche d'abord « Aller au contenu »repère 1.

Avant d'écrire ces fichiers, ouvrez Apparence > Éditeur > Modèles : un modèle modifié dans l'éditeur de site est une copie en base, que WordPress sert avant le thème enfant. Seuls ces modèles proposent « Réinitialiser », qui efface la copie. Copie en base ou fichier du thème enfant, le modèle corrigé ne suit plus les changements de Littoral : relisez-le à chaque mise à jour du thème.

#L'extension : par ses réglages, ou chez son éditeur

Une correction tapée dans les fichiers d'une extension disparaît à la mise à jour, qui écrase l'ancienne version. Le plus simple est un réglage de l'extension. Viennent ensuite, dans le thème enfant, un filtre ou, si elle en prévoit, une surcharge. Le filtre render_block_resa-escale/reservation réécrit le HTML du bloc sur le site public. Reste enfin à écrire à l'éditeur de l'extension, ou à en changer. Résa Escale n'a aucun réglage pour ses étiquettes, et l'agence a choisi d'écrire à son éditeur : le critère 11.1 reste en échec jusqu'à la correction du formulaire.

#La page : la rédaction, dans l'éditeur et la médiathèque

Une fois le thème corrigé, il reste le formulaire et deux défauts de la rédaction. Le taux de conformité qu'affiche la déclaration est la part des critères validés parmi les applicables. Un seul élément en échec invalide un critère sur sa page, et un critère invalidé sur une seule page de l'échantillon ne compte pas comme validé. Pour ce taux, un défaut saisi par la rédaction sur une seule page coûte donc autant qu'un défaut du thème présent partout.

Sur « Les marais salants », le paragraphe gris retrouve la couleur du thème par « Effacer », dans Typographie > Couleur : son contraste sur le blanc passe à 15,97:1. Pour l'affiche de « Fête de la sardine », remplir son texte alternatif dans la médiathèque ne met pas à jour une image déjà insérée. Sur notre démo, la médiathèque a ce texte ; l'article garde alt="". Le texte de la médiathèque sert aux images que le thème appelle, comme l'image mise en avant. Celui de l'article se saisit dans le bloc Image (quoi y écrire).

Capture d'écran : l'éditeur de WordPress sur l'article « Fête de la sardine », l'affiche sélectionnée et, dans la colonne des réglages du bloc Image, le champ « Texte alternatif » rempli.Repère 1. Le champ « Texte alternatif » du bloc Image, rempli avec le nom, la date et le lieu de la fête.
Dans l'article « Fête de la sardine », le champ « Texte alternatif » du bloc Imagerepère 1 reçoit ce que dit l'affiche : le nom de la fête, sa date et son lieu.

Sur Port-Marzelle, l'agence a corrigé les modèles de Littoral une fois, et le formulaire attend l'éditeur de Résa Escale. La rédaction, elle, a rendu deux critères valides en corrigeant elle-même ses défauts, là où elle les avait publiés. WordPress l'avait d'ailleurs prévenue pour le gris : dans les réglages du paragraphe, il affiche « Cette couleur offre un faible contraste par rapport à l'arrière-plan ». La page est partie en ligne quand même.

Déclaration d'accessibilité d'un site web : du rapport d'audit à la page en ligne

Après chaque mise à jour de WordPress, du thème ou d'une extension, l'agence analyse avec Includdy une page par modèle et le formulaire. Elle compare les non-conformités à celles d'avant. Chaque nouvelle page de la rédaction s'analyse de même. Pour chaque non-conformité, Includdy génère un plan de test que la rédaction peut rejouer.


Partagez cet article

Questions fréquentes

Aucune ne le fait à elle seule. Selon la DINUM, les outils de surcouche, ces barres ou widgets d'accessibilité ajoutés au site, ne permettent en aucun cas de rendre un site accessible ni de respecter la loi française. L'audit juge les pages de l'échantillon telles que le thème, les extensions et les contenus les produisent.

Le RGAA 5, dont la sortie est prévue en décembre 2026, ajoutera des critères sur ces surcouches.

Non. Le manuel de revue des thèmes précise que l'étiquette ne signifie pas que le thème respecte les WCAG au niveau AA. Elle dit que le thème atteint les exigences minimales de l'équipe de revue, comme un lien d'évitement, des champs étiquetés ou un contraste suffisant. Le manuel ajoute que les WCAG mesurent un contenu et ne s'appliquent pas à un thème seul.

Les modèles du thème, les extensions et les pages saisies par la rédaction restent donc à auditer, comme sur tout site. Sur Shopify, la boutique de thèmes n'affiche aucune étiquette d'accessibilité : voyez ce que Shopify vérifie sur un thème, et ce qu'il reste à tester.

L'article 47 de la loi de 2005 vise les personnes morales de droit public, comme un office de tourisme constitué en établissement public. Parmi les organismes privés, il vise les délégataires d'une mission de service public. Il vise aussi ceux créés pour des besoins d'intérêt général autres qu'industriels ou commerciaux, si le secteur public finance la majorité de leur activité ou contrôle leur gestion. Il suffit encore que le secteur public désigne plus de la moitié des membres de leur organe d'administration, de direction ou de surveillance. Le texte vise également les organismes privés créés pour ces mêmes besoins par une personne publique ou par l'un de ces organismes. Il vise enfin les entreprises dont le chiffre d'affaires annuel réalisé en France dépasse 250 millions d'euros, en moyenne sur les trois derniers exercices clos. Elles peuvent auditer avec une autre méthode de test, si elles la communiquent sur demande, la relient à la norme par une table de correspondance et l'indiquent dans leur déclaration.

Les organismes privés à but non lucratif qui ne fournissent ni services essentiels ni services destinés aux personnes handicapées sont exclus. L'audit peut être fait par l'organisme lui-même ou par un tiers, et la déclaration d'accessibilité en publie le résultat.