Pas à pas

React Router : mettre à jour le titre de la page et déplacer le focus à chaque route

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

Le développeur front qui change le titre à chaque route React Router a réglé un signal sur trois. Un vrai chargement remettait aussi le focus en haut et annonçait la nouvelle page au lecteur d'écran : React Router laisse ces deux tâches à l'application. Un seul appel de focus, sur le nouveau titre, fait les deux : la personne au clavier repart de là, et le lecteur d'écran le lit.

Du lien au test en deux minutes


#Que se passe-t-il quand un lien React Router change la page ?

Un lecteur d'écran ne dit rien après un lien React Router, faute de chargement de page à annoncer : le lien remplace la vue sur place. L'onglet garde son ancien titre, le focus ne revient pas en haut, et le lecteur d'écran n'a aucun chargement à signaler, un moment pour lequel VoiceOver a même un réglage. Les personnes qui naviguent au clavier ou avec un lecteur d'écran comptent sur ces deux derniers signaux.

La page accessibilité de React Router cite la gestion du focus et les annonces parmi les points à prévoir, sans code, dans une section consacrée à son mode framework. Notre démo tourne sous React Router 8.5.1 en mode déclaratif, la configuration simple avec <BrowserRouter>. C'est l'espace abonné de Wild Rye Farm Share, un abonnement à des paniers de légumes, où une personne au clavier ouvre « Deliveries » (les livraisons) pour sauter le panier de la semaine prochaine. La démo est en anglais : nous citons ses libellés tels quels.

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

Dans l'application Wild Rye sans correctif, après Entrée sur « Deliveries », le Tab suivant arrive sur « Add-ons » : le champ « Find a delivery » ne vient qu'au quatrième appui.

WebKit, le moteur de Safari, donne le même compte avec Option+Tab, puisque son Tab seul saute les liens. Un lien placé dans l'ancienne vue s'en sort mieux : « See past deliveries » disparaît avec sa vue, le focus retombe sur la page, et l'appui suivant arrive dans la nouvelle vue, sur « Rate this box ».

Une personne au lecteur d'écran qui suit « Deliveries » peut ne pas comprendre que la page a changé, comme le signalent les tests utilisateurs de 2019 cités dans la documentation de React Router.


#Comment changer le titre de la page et déplacer le focus à chaque route React Router ?

Donnez à chaque route son propre <title>, puis déplacez le focus sur le titre principal de la nouvelle vue.

#Comment poser le titre de page de chaque route ?

Affichez un <title> dans chaque composant de route : React 19 le place dans le <head>, où qu'il soit dans l'arbre. React Router 8 demande React 19.2.7 ou plus et ne publie plus react-router-dom. Importez depuis react-router, que la version 7 accepte aussi.

const SITE = "Wild Rye Farm Share";
 
function Deliveries() {
  return (
    <section>
      <title>{`Deliveries | ${SITE}`}</title>
      <h1>Your deliveries</h1>
      {/* le filtre et la liste des paniers */}
    </section>
  );
}

React attend une seule chaîne dans <title>. Sur notre démo, <title>{name} | Wild Rye Farm Share</title> lui donnait deux morceaux, et le titre sortait vide, sans avertissement dans la console. Un gabarit de chaîne (template literal) n'en fait qu'une.

Gardez un seul <title> à la fois, et aucun dans le layout. Le critère 8.6 du RGAA demande un titre de page pertinent. Dans une application monopage, il doit donc suivre la vue, comme le précise la fiche du W3C sur ce point.

#Où placer le focus après un changement de route ?

Le RGAA vous laisse le choix de la cible. Son critère 12.8 demande seulement que l'ordre de tabulation reste cohérent après un script qui met à jour le contenu. Les deux schémas ci-dessous y répondent. Parmi les cibles testées en 2019, les testeurs au lecteur d'écran préféraient le titre : il leur ferait gagner du temps et montrerait clairement ce qui s'est passé.

Après un second test, la recommandation finale de l'étude change : un lien d'évitement qui prend le focus à chaque changement de route. Une région live, un élément dont le lecteur d'écran lit le nouveau texte, existe dès le chargement et nomme la nouvelle page. Sur le téléphone du testeur qui utilisait un agrandisseur, donner le focus à un titre ou à un conteneur bien plus large que l'écran faisait défiler la vue jusqu'à son milieu. Le texte était coupé aux deux bouts. Le Chrome de Samsung semblait y être pour quelque chose. Ce qui convient à une personne handicapée, ajoute l'autrice de l'étude, peut ne pas convenir à une autre.

#Pourquoi nous recommandons de donner le focus au titre ?

Nous recommandons quand même le h1, à condition qu'il tienne dans un écran de téléphone : sur Wild Rye, « Your deliveries » occupe 310 pixels sur 360, sur une seule ligne. Un seul geste place la personne au clavier au début du nouveau contenu et donne son titre au lecteur d'écran. MDN ajoute que les régions live se comportent différemment selon le couple navigateur et lecteur d'écran, et conviennent mal à un changement qui déplace le focus.

Le mode déclaratif n'a pas de ScrollRestoration pour remettre le défilement à zéro : dans une fenêtre de la taille d'un téléphone, l'application sans correctif ouvrait « Past deliveries » avec son titre plus de 200 pixels au-dessus de l'écran. focus() règle ce point : il fait défiler la page jusqu'au titre.

Sur le titre qui reçoit le focus, le contour :focus-visible de l'application s'affiche dans Chrome après Entrée seulement, dans WebKit après un clic aussi. Gardez-le : les testeurs voyants de 2019 jugeaient le focus visible utile, même si l'un d'eux notait qu'un contour sur un élément inactif peut dérouter. Le testeur en commande vocale repérait plus facilement le contour sur un titre que sur un large conteneur. Le style du contour se règle avec :focus-visible.

Focus visible : styler l'indicateur de focus en CSS

#Quand préférer un lien d'évitement et une région live ?

Choisissez le schéma de l'étude de 2019 quand les vues ne peuvent pas garantir un h1 dès l'affichage : une vue derrière un écran de chargement, un tableau de bord qui n'en a pas. Le focus arrive sur un lien d'évitement fonctionnel dans la vue, comme le « skip to main navigation » de l'étude, et aucun élément large ne le reçoit. Sur Wild Rye, un lien « Skip to main content » en haut de page coûte une touche de plus : Entrée dessus, puis Tab, pour atteindre « Find a delivery ».

Ce schéma a deux pièces à entretenir, et la région live doit exister dès le premier rendu, dans la coquille de l'application. Choisissez un seul schéma : un titre focalisé plus une région qui répète son nom feraient entendre ce nom deux fois.

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

#Comment écrire le hook de focus ?

Le code de focus tient dans un petit hook, appelé dans le layout qui affiche <Outlet /> dans <main>. React exécute les effets une fois la nouvelle vue dans la page.

Indexé sur location, comme dans l'exemple useLocation de React Router, ce hook cassait le filtre de Wild Rye. La location comprend la chaîne de requête et l'ancre, et le filtre écrit son texte dans l'URL sous la forme ?q= : la première lettre tapée compte comme une navigation. Après « k », le focus sautait sur le titre, et « ale » partait dans le vide, à la souris comme au clavier. Indexé sur pathname, le hook ignore le filtre.

À éviter

Capture : le haut de la vue « Your deliveries » de Wild Rye, avec un contour rouille autour du titre et la seule lettre k dans le champ « Find a delivery ».Repère 1. Le titre « Your deliveries », qui a pris le focus après la première lettre. Repère 2. Le champ « Find a delivery », qui ne contient que la lettre k.
const location = useLocation();
const previous = useRef(location);
 
useEffect(() => {
  if (previous.current === location) return;
  previous.current = location;
  // focus sur le nouveau h1
}, [location]);

Correct

Capture : la même vue, avec le contour rouille autour du champ « Find a delivery », qui contient le mot kale.Repère 2. Le champ « Find a delivery », toujours focalisé, avec le mot kale en entier.
const { pathname } = useLocation();
const previous = useRef(pathname);
 
useEffect(() => {
  if (previous.current === pathname) return;
  previous.current = pathname;
  // focus sur le nouveau h1
}, [pathname]);
Indexé sur location, le hook envoie le focus sur le titrerepère 1 dès que « k » arrive dans « Find a delivery »repère 2. Indexé sur pathname, le focus reste dans le champrepère 2, et « kale » s'écrit en entier.

La comparaison des chemins laisse aussi le premier chargement au navigateur. Un booléen « premier passage » semble équivalent, mais le mode strict exécute les effets une fois de plus en développement. Sur notre démo, la version à booléen envoyait le focus sur le titre à chaque chargement en développement, jamais en production.

Le hook donne au titre tabindex="-1" : un script peut lui donner le focus, et Tab le saute. Une vue sans h1 se rabat sur <main>, que les testeurs de 2019 au lecteur d'écran trouvaient correct, bien moins visible qu'un titre.

import { useEffect, useRef } from "react";
import { Outlet, useLocation } from "react-router";
 
export function useFocusOnRouteChange() {
  const { pathname } = useLocation();
  const previous = useRef(pathname);
 
  useEffect(() => {
    if (previous.current === pathname) return;
    previous.current = pathname;
    const target =
      document.querySelector("main h1") ?? document.querySelector("main");
    if (!target) return;
    if (!target.hasAttribute("tabindex")) target.setAttribute("tabindex", "-1");
    target.focus();
  }, [pathname]);
}
 
export function Layout() {
  useFocusOnRouteChange();
  return (
    <>
      <Header />
      <main>
        <Outlet />
      </main>
    </>
  );
}

#Comment tester un changement de route React Router au clavier et au lecteur d'écran ?

Chaque route se teste en deux minutes environ : quatre touches dans le navigateur, puis le même lien avec NVDA ou VoiceOver. Sur Mac, Safari demande deux réglages. Son Tab saute les liens tant que l'option « Appuyer sur Tab pour mettre en évidence chaque élément d'une page web » n'est pas cochée dans ses réglages avancés, et les boutons tant que la navigation au clavier n'est pas activée dans macOS.

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

Dans l'application Wild Rye corrigée, un seul Tab après le lien arrive dans la nouvelle vue, sur « Find a delivery », et la lettre « k » tapée dans le champ y laisse le focus.

Lancez ensuite un lecteur d'écran et suivez à nouveau le lien « Deliveries ». Le nouveau titre doit être lu une fois : un silence, ou le nom lu deux fois, veut dire que le hook est à revoir. Nos essais n'avaient pas de lecteur d'écran : cette écoute reste à faire sur une vraie machine.

Commencez par NVDA, gratuit sous Windows : neuf répondants sur dix à l'enquête WebAIM 2026 utilisent Windows, et seulement 6,5 % ont VoiceOver comme lecteur principal sur ordinateur. Sur le Mac d'un développeur, VoiceOver s'active avec Cmd+F5, et Ctrl interrompt sa lecture.

Titre et focus rétablis, une personne au clavier saute le panier de la semaine prochaine en quatre touches depuis « Deliveries » : Entrée, deux fois Tab, puis Entrée sur le jeudi 19 novembre, dont le bouton affiche alors « Box skipped ». L'application sans correctif en demandait sept, en passant d'abord par « Add-ons », « Recipes » et « Account ».

Lecteur d'écran NVDA : installer, régler et tester une page avec Firefox

Includdy, gratuit dans sa formule Free, analyse la page affichée et peut l'ajouter à un snapshot, une analyse datée des pages du site. Ses vérifications manuelles y demandent si le titre de la page décrit la page et si chaque titre visible, le h1 focalisé compris, est balisé comme tel.


Partagez cet article

Questions fréquentes

Oui. Next.js intègre un annonceur de route : il cherche le nom de la page dans document.title, puis dans le <h1>, puis dans le chemin de l'URL, comme l'explique sa documentation sur l'accessibilité, qui demande aussi un titre unique et descriptif sur chaque page.

React Router n'a pas d'annonceur : sa page sur l'accessibilité laisse la gestion du focus et les annonces à l'application.

Avec un message de statut : un élément role="status", présent dès le premier rendu, dont le texte change, par exemple « 2 paniers trouvés ». MDN rappelle qu'une région live doit exister avant que son contenu change, et une région de statut est polie : le lecteur d'écran lit le changement quand la personne ne fait rien.

Le RGAA le vérifie au critère 7.5. Un changement de route est un changement de contexte, qui relève d'un autre critère, le 7.4.

Aucun texte ne nomme la technique, mais le RGAA 4.1.2 couvre le résultat. Le critère 12.8 demande que l'ordre de tabulation reste cohérent quand un script met à jour le contenu. Un autre critère exige un titre de page pertinent. Un lien qui remplace la vue sans déplacer le focus ni changer le titre échoue donc à ces tests.

Le RGAA s'impose aux services publics et aux grandes entreprises au titre de l'article 47 de la loi de 2005 et de son décret d'application. Depuis le 28 juin 2025, la directive européenne sur l'accessibilité s'applique aussi au commerce électronique et aux services bancaires, entre autres, et la DGCCRF fait partie des autorités qui contrôlent ces services. Les microentreprises de services (moins de 10 salariés et moins de 2 millions d'euros de chiffre d'affaires) en sont dispensées.