Pas à pas

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

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

Un lien d'évitement, c'est un lien « Aller au contenu » placé tout en haut de la page : au clavier, la personne appuie sur Entrée et arrive dans le contenu, sans traverser tout le menu. Il tient en une ligne de HTML et quelques lignes de CSS, sans JavaScript. Voici le code à copier, et le test en trois touches qui montre s'il marche vraiment.

Du gabarit au test en trois touches


#Quel code HTML et CSS pour le lien d'évitement ?

Sans lien d'évitement (skip link en anglais), quiconque navigue avec Tab traverse tout l'en-tête à chaque page. Le W3C, auteur des WCAG, parle de dizaines d'appuis : c'est long, et douloureux pour certains.

Le code compte trois éléments : un lien vers #contenu en tête de <body>, id="contenu" sur <main>, et une règle CSS qui cache le lien jusqu'au focus. Le système de design de GOV.UK place le lien juste après <body>, ou juste après le bandeau cookies s'il y en a un. Le lien vise <main>, l'élément qui porte le contenu principal de la page. WordPress pose ce lien lui-même dès que le modèle d'un thème de blocs contient <main>, et un modèle qui n'en a pas en prive toutes ses pages.

<body>
  <a class="lien-evitement" href="#contenu">Aller au contenu</a>
  <header>…</header>
  <main id="contenu">…</main>
</body>

Le lien peut rester visible en permanence, ou n'apparaître qu'au focus. Toujours visible, il sert davantage : au clavier naviguent aussi des personnes qui utilisent une loupe d'écran ou la commande vocale. Le Bureau des guides de Valcerne, notre exemple, l'affiche au focus. Pour son contour, voyez l'article sur le focus visible.

#Comment le cacher sans le rendre inatteignable ?

Avec display: none ou l'attribut hidden, le navigateur affiche la page comme si le lien n'existait pas, et un élément ainsi retiré de l'affichage ne reçoit pas le focus. visibility: hidden lui retire aussi le focus : dans les trois cas, Tab saute le lien.

Le WebAIM Million 2026 a analysé les pages d'accueil du million de sites les plus populaires. Un lien d'évitement sur dix y était cassé : caché de façon inaccessible, ou sans cible dans la page. Pour cacher le vôtre, prenez une technique de masquage visuel, qui l'efface de l'écran mais le laisse atteignable au clavier, et levez-la au focus.

À éviter

Capture d'écran : l'en-tête du Bureau des guides de Valcerne, le contour de focus rouge autour du logo.Repère 1. Le logo de Valcerne, qui reçoit le focus au premier appui sur Tab.
.lien-evitement {
  display: none;
}

Correct

Capture d'écran : le lien « Aller au contenu », en blanc sur noir, posé en haut à gauche de l'en-tête et entouré du contour de focus rouge.Repère 1. Le lien « Aller au contenu », affiché au premier appui sur Tab, par-dessus le logo.
.lien-evitement {
  position: absolute;
  top: 1rem;
  left: 1rem;
  z-index: 100;
  clip-path: inset(50%);
  width: 1px;
  height: 1px;
  overflow: hidden;
  white-space: nowrap;
}
 
.lien-evitement:focus {
  clip-path: none;
  width: auto;
  height: auto;
  padding: 0.75rem 1rem;
  background: #111111;
  color: #ffffff;
  box-shadow: 0 6px 18px rgb(0 0 0 / 0.35);
}
Au premier Tab, avec display: none, le focus saute le lien et tombe sur le logo de Valcernerepère 1 ; caché jusqu'au focus, « Aller au contenu »repère 1 apparaît par-dessus l'en-tête.
Liens « En savoir plus » : les rendre clairs pour un lecteur d'écran

#Pourquoi la page défile mais la tabulation repart du menu ?

Un script de défilement doux intercepte le clic pour faire glisser la page lui-même jusqu'à la cible : le navigateur ne suit plus le lien. Le focus reste sur « Aller au contenu », et le Tab suivant repart dans l'en-tête. Rejouez ce parcours ci-dessous, ou sur la page avec script.

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

Sur la page avec script du Bureau des guides de Valcerne, le second Tab met le focus sur le logo et fait remonter la page : le script a annulé le saut vers le contenu.

#Comment garder le défilement doux sans casser le lien ?

Depuis 2016, quand on suit un lien vers une ancre comme #contenu, la spécification HTML impose au navigateur de placer sur la cible le point de départ de la navigation au clavier. Le Tab suivant part de là dans l'ordre de tabulation.

Le script de défilement doux, lui, appelle preventDefault(), qui empêche le navigateur de suivre le lien. Le point de départ ne bouge donc pas, et Tab passe à l'élément qui suit le lien : le logo.

Retirez le script et posez scroll-behavior: smooth sur html, l'élément racine. Cette propriété adoucit le défilement d'un saut vers une ancre. Posée sur body, elle ne règle pas le défilement de la page. Placez-la dans @media (prefers-reduced-motion: no-preference), pour que les personnes qui ont demandé moins d'animations à leur appareil gardent un saut immédiat.

À éviter

Capture d'écran : le haut de la page de Valcerne, le contour de focus rouge autour du logo, au-dessus du bandeau des conditions du jour.Repère 1. Le logo de Valcerne, qui reçoit le focus au second appui sur Tab.
document.querySelectorAll('a[href^="#"]').forEach((lien) => {
  lien.addEventListener("click", (event) => {
    event.preventDefault();
    document
      .querySelector(lien.getAttribute("href"))
      .scrollIntoView({ behavior: "smooth" });
  });
});

Correct

Capture d'écran : le titre « Initiation à la cascade de glace » et son paragraphe, le contour de focus rouge autour du lien « liste du matériel ».Repère 1. Le lien « liste du matériel », premier lien du contenu principal, qui reçoit le focus au second appui sur Tab.
@media (prefers-reduced-motion: no-preference) {
  html {
    scroll-behavior: smooth;
  }
}
Au second Tab, avec le script, le focus revient au logo de Valcernerepère 1 ; avec scroll-behavior en CSS, il entre dans le contenu, sur le lien « liste du matériel »repère 1.

#Faut-il ajouter tabindex="-1" sur la cible ?

Pour le clavier, non : la spécification HTML impose déjà au navigateur de placer sur la cible le point de départ de la navigation au clavier. tabindex="-1" n'est plus ce qui fait marcher le lien au clavier. Un billet de Chrome de 2016 le demandait encore, le temps que tous les navigateurs gèrent ce point de départ. Avec un lecteur d'écran, rien ne garantit que la lecture reprenne à la cible sans tabindex : vérifiez-la à part, par exemple avec NVDA.

L'attribut a un effet de bord : <main> prend le focus au clic, et un contour l'entoure si votre style de focus vise :focus. Le billet de 2016 conseillait de retirer ce contour.


#Comment tester le lien d'évitement sur chaque gabarit ?

Pour chaque gabarit de page, chargez-en une dont le contenu principal a un lien, un bouton ou un champ, bandeau cookies fermé. Sur une autre page, le test peut échouer alors que le lien marche. Appuyez sur Tab, Entrée, Tab : le second Tab doit arriver dans le contenu principal. Ne cliquez pas dans la page entre-temps : un clic déplace aussi le point de départ de la navigation au clavier.

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

Sur la page sans script du Bureau des guides de Valcerne, le second Tab arrive sur « liste du matériel », le premier lien du contenu principal : le navigateur a bien fait le saut.

Avec ou sans script, la page défile : seul le second Tab montre si le lien marche. S'il revient dans l'en-tête, vérifiez que <main> porte id="contenu" et qu'aucun script n'intercepte le clic. Si un en-tête collant recouvre le début du contenu, posez scroll-padding-top sur html pour réserver sa hauteur. L'article sur le RGAA 5 en donne le code.

Le RGAA demande ce lien dans chaque page (critère 12.7) : cochez ces points sur chaque gabarit.

#Pourquoi la tabulation saute le lien dans Safari ?

Sur Mac, tant qu'un réglage reste décoché, Safari ne fait jamais passer Tab par les liens, « Aller au contenu » compris. Cochez « Utiliser la touche Tab pour mettre en surbrillance les éléments des pages web » dans Safari > Réglages > Avancés. Sans ce réglage, Option+Tab, lui, passe par les liens.

Capture d'écran : la rubrique Accessibilité des réglages Avancés de Safari, la case « Utiliser la touche Tab pour mettre en surbrillance les éléments des pages web » cochée.Repère 1. La case « Utiliser la touche Tab pour mettre en surbrillance les éléments des pages web », cochée, et la note sur Option+Tab dessous.
Dans les réglages Avancés de Safari, la case cochéerepère 1 fait passer Tab par les liens ; Safari précise dessous qu'Option+Tab ne parcourt plus alors que les champs de texte et les menus.

Le test en trois touches couvre le clavier. Un audit RGAA vérifie aussi la lecture avec des lecteurs d'écran : Includdy réalise ces audits.


Partagez cet article

Questions fréquentes

Un lien d'accès rapide mène à une zone de la page, comme le menu ou la recherche, et un lien d'évitement fait sauter une zone. Le lien « Aller au contenu » fait les deux : il saute l'en-tête et mène au contenu principal, d'où ses deux noms.

Non. Leur critère 2.4.1 Contourner des blocs demande un mécanisme pour éviter les blocs répétés d'une page à l'autre. Un lien en haut de page vers le contenu principal en est un ; des repères ARIA ou des titres en début de section en sont d'autres.

Sans tabindex, <main> ne peut pas prendre le focus : le navigateur le donne à la page elle-même, et document.activeElement renvoie body. Le navigateur déplace pourtant sur <main> le point de départ de la navigation au clavier, si bien que le Tab suivant part de là.

Pour vérifier le lien, bandeau cookies fermé, fiez-vous donc à Tab, Entrée, Tab : si le contenu principal a un lien, un bouton ou un champ, le second Tab doit y arriver.