Skip to content
Floskool

Chapter 6 · Chapitre 6 · Responsive et accessibilité

6.2 Accessibilité : titres, textes alternatifs, contrastes, menu au clavier

Free lesson 10 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Un site accessible, c'est un site que tout le monde peut utiliser : une personne malvoyante avec un lecteur d'écran (logiciel qui lit la page à voix haute), quelqu'un qui navigue au clavier, ou toi-même au soleil avec 10 % de batterie. Bonne nouvelle : les bases tiennent en quatre points, et Claude Code les connaît bien.

Pourquoi ça te concerne

Pense à un client de l'Atelier Mona qui commande des fleurs pour sa mère, avec un lecteur d'écran. Si les titres sont mal rangés, il ne peut pas sauter à la section « Contact ». Si le bouton menu n'annonce rien, il ne sait pas qu'il existe. Un site accessible est aussi plus clair pour tout le monde, et plus facile à comprendre pour les moteurs de recherche.

On vise le niveau AA des WCAG (les règles internationales d'accessibilité du web), déjà évoqué dans le chapitre 5 sur le design.

1. Les titres : un plan lisible

Une page a un seul titre h1 (le titre principal), puis des h2 pour les sections, des h3 à l'intérieur. Jamais de saut de niveau choisi « parce que c'est plus joli » : la taille, c'est le CSS qui s'en charge.

Sur la démo, le contrôle automatique a compté 1 h1. Chaque section est reliée à son titre, ce qui permet au lecteur d'écran d'annoncer « Contact, région » :

<section id="contact" class="section" aria-labelledby="titre-contact">
  <div class="container contact">
    <h2 id="titre-contact">Contact</h2>

2. Les textes alternatifs

Le texte alt décrit une image pour ceux qui ne la voient pas. Règle simple : une image qui porte une information reçoit une description ; une image purement décorative est masquée aux lecteurs d'écran.

La démo n'a aucune balise <img> : ses visuels sont des dessins SVG intégrés. Claude Code a donc appliqué la même logique autrement. Les 2 illustrations qui comptent ont role="img" et une description, par exemple « Illustration d'un bouquet de fleurs roses et jaunes dans un vase vert ». Les emoji décoratifs des cartes services ont aria-hidden="true" (masqués aux lecteurs d'écran). Quand tu ajouteras tes vraies photos, chacune aura un alt précis : pas « photo1 », mais « Bouquet de pivoines roses dans du papier kraft ».

3. Les contrastes

Le contraste, c'est l'écart de luminosité entre le texte et le fond, exprimé en ratio. Pour du texte de taille normale, le niveau AA demande au moins 4.5:1.

Sur la démo, les ratios ont été calculés avec la formule WCAG. Le texte sur fond crème atteint 13.29:1, le bouton blanc sur vert 6.08:1. Mais deux éléments échouaient au départ : le petit sur-titre rose (3.77:1) et le badge « exemple » (3.96:1). Claude Code a assombri le rose de #c4615c à #a5443f, ce qui donne 5.62:1 et 5.90:1. Une seule variable modifiée, tout le site corrigé.

4. Le menu et le site au clavier

Beaucoup de gens naviguent avec la touche Tab (élément suivant), Maj + Tab (précédent) et Entrée (activer). Trois choses rendent ça possible sur la démo :

  • un lien d'évitement « Aller au contenu », invisible jusqu'au premier Tab, qui saute le menu ;
  • un contour de focus bien visible (:focus-visible { outline: 3px solid var(--rose); }) ;
  • un vrai bouton <button> pour le menu, qui annonce son état avec aria-expanded :
toggle.addEventListener('click', () => {
  const open = toggle.getAttribute('aria-expanded') === 'true';
  toggle.setAttribute('aria-expanded', String(!open));
  toggle.querySelector('.sr-only').textContent = open ? 'Ouvrir le menu' : 'Fermer le menu';
  nav.classList.toggle('is-open', !open);
});

Le test l'a confirmé : menu fermé au chargement, puis après clic aria-expanded="true" et libellé « Fermer le menu », puis menu refermé après un clic sur « Contact ».

Pas à pas : l'audit avec Claude Code

Fais un audit d'accessibilité de mon site, sans rien modifier :
- Titres : un seul h1 par page, h2 et h3 dans l'ordre, sections reliées à leur titre.
- Images : alt descriptif pour les images utiles, images décoratives masquées aux lecteurs d'écran.
- Contrastes : calcule le ratio WCAG de chaque couple texte/fond de mon CSS, et signale tout ce qui est sous 4.5:1 pour du texte normal, avec une couleur proche qui passe.
- Clavier : lien d'évitement, focus visible, menu mobile utilisable au clavier avec aria-expanded.
- Formulaire : chaque champ a une étiquette reliée.
Rapport OK / à corriger, puis propositions. Attends mon accord avant d'appliquer.

Ensuite, fais le test humain : débranche ta souris et parcours toute la page avec Tab. Tu dois toujours voir où tu es, et pouvoir ouvrir le menu avec Entrée.

Si ça coince

  • Le contour de focus est invisible. Souvent, une règle outline: none traîne dans le CSS. Demande de la remplacer par un :focus-visible bien contrasté.
  • Claude propose de changer ta couleur de marque. Garde-la pour les grands éléments décoratifs et le logo ; seule la version utilisée pour le petit texte est assombrie, comme le rose de la démo.
  • Le menu s'ouvre à la souris mais pas au clavier. Le déclencheur est sans doute un <div> : exige un vrai <button type="button">.
  • Tu ne sais pas quoi écrire dans un alt. Décris ce qu'une personne au téléphone dirait à quelqu'un qui ne voit pas l'image, en une phrase.

À toi de jouer

Lance l'audit, puis fais le test « sans souris » sur ta page d'accueil. Note chaque endroit où tu perds le focus de vue. Envoie tes notes à Claude Code et valide les corrections une par une.

En bref

  • Un h1 par page, des titres dans l'ordre : c'est le plan de ta page.
  • Alt descriptif pour les images utiles, décor masqué aux lecteurs d'écran.
  • Contraste d'au moins 4.5:1 pour le texte normal : la démo est passée de 3.77:1 à 5.62:1 en changeant une variable.
  • Lien d'évitement, focus visible et vrai bouton aria-expanded pour le clavier.
  • Termine toujours par un vrai test au clavier, sans souris.