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


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.
Repère 1. Le modèle « Pages » du thème Littoral, qui sert à sept des treize pages de l'échantillon.| Modèle | Pages de l'échantillon |
|---|---|
| Page d'accueil | Accueil |
| Pages | Contact Mentions légales Accessibilité Plan du site Choisir une visite Vos coordonnées Les marais salants |
| Publications seules | Fête de la sardine Marché du sel (au hasard) Nuit des étoiles (au hasard) |
| Toutes les archives | Agenda |
| Résultats de recherche | Recherche « 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.
« Port-Marzelle », le titre du site. Aucun lien « Aller au contenu » ne le précède.
« Visites », premier lien du menu.
« Agenda ».
« Les marais salants ».
« Contact ».
« Réserver », bouton de l'en-tête.
Le focus entre enfin dans le contenu, 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.
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) ».#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
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
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 -->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).
Repère 1. Le champ « Texte alternatif » du bloc Image, rempli avec le nom, la date et le lieu de la fête.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.


