Pas à pas

Focus visible : styler l'indicateur de focus en CSS

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

Si votre équipe de design a retiré du CSS le contour des boutons cliqués, les personnes voyantes qui naviguent au clavier ne savent plus où elles en sont. Ce contour, l'indicateur de focus, montre quel élément reçoit les touches. Avec :focus-visible, vous le masquez au clic et le gardez au clavier. Nous donnons un style lisible sur tout fond uni et la façon de le tester.

Un seul style de focus, du CSS au test


#À quoi sert l'indicateur de focus clavier ?

L'indicateur de focus montre à l'écran quel élément recevra la prochaine touche du clavier. Cet élément, c'est le focus : le lien qu'Entrée va ouvrir, le champ où s'inscrivent les lettres. C'est le plus souvent un contour, comme sur le site de l'Horlogerie Balancier, un réparateur de montres que nous suivrons jusqu'au test.

Capture d'écran : le menu de l'Horlogerie Balancier, le lien « Tarifs » entouré de bleu.Repère 1. Le lien « Tarifs » du menu, entouré du contour bleu du focus.
Après trois appuis sur Tab, seul le contour bleu de 2 px autour de « Tarifs »repère 1 montre où se trouve le focus clavier.

Sans ce contour, une personne voyante qui navigue au clavier ne sait plus où elle est. Ce repère aide :

  • les personnes qui ne peuvent pas utiliser une souris ou doivent l'éviter, à cause d'un handicap moteur, de douleurs dues aux gestes répétés ou d'un bras dans le plâtre ;
  • celles qui pilotent l'ordinateur à la voix, avec un clavier affiché à l'écran ou avec un contacteur (un bouton adapté), car ces outils agissent comme un clavier ;
  • les personnes malvoyantes qui agrandissent l'écran et n'en voient qu'une partie à la fois ;
  • celles qui ont des troubles de l'attention ou de la mémoire, et doivent retrouver où elles en sont.

Les personnes aveugles naviguent au clavier elles aussi, mais un lecteur d'écran les guide en leur lisant la page. Le contour sert d'abord à celles qui voient l'écran.

Pendant des années, les navigateurs ont dessiné ce contour sur presque tout élément qui recevait le focus, même sur un bouton cliqué. Beaucoup le trouvaient laid, et de nombreux sites l'ont retiré, si bien que, sur ces sites, les personnes de la liste ont perdu leur repère.

Depuis, les navigateurs n'affichent leur contour que lorsqu'il est utile, surtout au clavier. En 2020, Chrome a aussi remplacé son contour clair par un anneau sombre bordé d'un fin trait blanc, pour mieux ressortir sur les fonds clairs comme sombres.

Les WCAG, les règles d'accessibilité du web, exigent un focus visible : c'est leur critère Visibilité du focus, de niveau AA. En France, le RGAA, la méthode officielle de test, vérifie au critère 10.7 que le focus se voit sur chaque élément qui le reçoit.


#Comment retirer le contour au clic et le garder au clavier ?

Posez votre style de focus sur :focus-visible, le sélecteur qui fait cette différence. Le sélecteur :focus s'applique chaque fois qu'un élément reçoit le focus, clic de souris compris. :focus-visible ne s'applique que quand le navigateur juge utile de montrer le focus : pendant la navigation au clavier, et toujours dans les champs où l'on tape du texte.

Quand un script déplace le focus, le nouvel élément montre en général l'anneau seulement si le précédent le montrait. Un troisième sélecteur, :focus-within, cible un élément quand lui-même ou un élément qu'il contient a le focus, par exemple une carte dont le lien a le focus.

Les navigateurs utilisent déjà :focus-visible pour leur propre style : un bouton cliqué n'affiche donc normalement aucun anneau. Si votre designer en voit un au clic, cherchez d'abord une règle :focus dans le CSS du site ou dans une bibliothèque de composants. Sur un champ de texte, en revanche, l'anneau au clic est voulu : la personne doit voir où elle écrit.

Capture d'écran : le bouton « Prendre rendez-vous » deux fois côte à côte. À gauche, cliqué, il n'a aucun anneau ; à droite, atteint avec Tab, un contour bleu très sombre l'entoure.
Le bouton « Prendre rendez-vous », stylé sur :focus-visible : à gauche, cliqué à la souris, il n'a aucun anneau ; à droite, atteint avec Tab, un contour bleu très sombre l'entoure.

Beaucoup de sites ont fait l'inverse, avec une règle outline: none sur :focus qui retire l'anneau pour tout le monde, clavier compris. Si aucun autre indicateur ne la remplace, le W3C, qui publie les WCAG, la range parmi les erreurs qui font échouer le critère du focus visible. Supprimez donc ces règles.

À éviter

Capture d'écran : le bouton « Prendre rendez-vous » a le focus clavier, sans aucun indicateur.Repère 1. Le bouton « Prendre rendez-vous », sans contour de focus.
*:focus {
  outline: none;
}

Correct

Capture d'écran : le même bouton, entouré d'un contour bleu très sombre.Repère 1. Le bouton « Prendre rendez-vous », entouré du contour bleu très sombre du focus.
:focus-visible {
  outline: 2px solid #193146;
  outline-offset: 2px;
}
Le bouton « Prendre rendez-vous »repère 1 a le focus clavier dans les deux cas : avec outline: none sur :focus, rien ne le montre ; avec le style sur :focus-visible, un contour bleu très sombre l'entoure.

Pourquoi. Le navigateur décide déjà quand montrer l'anneau, et votre CSS n'a plus qu'à choisir son apparence.

L'ancienne astuce :focus:not(:focus-visible) et le script npm focus-visible, qui imitait le sélecteur, ne servent donc plus. Le sélecteur marche dans tous les principaux navigateurs depuis mars 2022, et le script n'est plus mis à jour.


#Quel style de focus choisir pour tout le site ?

Dessinez l'indicateur avec outline sur :focus-visible, et rangez ses couleurs dans des variables CSS. Un outline ne prend aucune place : rien ne bouge quand il apparaît, et il suit l'arrondi fixé par border-radius.

Plus le contraste entre deux couleurs est élevé, mieux on les distingue. Un indicateur tracé autour de l'élément doit atteindre 3:1 au moins avec le fond où l'élément est posé : les WCAG le demandent, et le RGAA reprend ce seuil. Mesurez chaque fond avec le vérificateur de contraste.

Mais si le site a des fonds de plusieurs couleurs, une seule couleur d'indicateur ne contraste pas forcément avec tous. Avec une couleur par zone, on oublie vite des composants. C'est pourquoi une technique du W3C dessine l'indicateur en deux couleurs : si elles atteignent 9:1 entre elles, l'une des deux atteint 3:1 sur n'importe quel fond uni. Cette garantie vaut pour un indicateur tracé autour de l'élément, sur un fond d'une seule couleur ; sur une photo ou un dégradé, mesurez.

L'Horlogerie Balancier est dans ce cas : sa page est blanche, et son pied de page bleu nuit #0F172A contient le formulaire de sa lettre d'information. Son focus actuel, un contour bleu #005FCC de 2 px, atteint 5,98:1 sur la page blanche et passe. Dans le pied de page, il tombe à 2,98:1 et échoue, car les WCAG n'arrondissent jamais un ratio.

La paire du W3C, #F9F9F9 presque blanc et #193146 bleu très sombre, offre 12,71:1 entre ses deux couleurs, au-delà des 9:1 demandés. Sur la page blanche, c'est la bande sombre qui assure le contraste, à 13,38:1. Dans le pied de page, la bande claire prend le relais, à 16,96:1.

Capture d'écran : les boutons « Prendre rendez-vous » et « S'inscrire » de l'Horlogerie Balancier avec leur focus, avant correction en haut et après correction en bas. En haut, le contour bleu ressort nettement sur la page blanche, moins sur le pied de page bleu nuit. En bas, le contour à deux couleurs ressort sur les deux fonds. Valeurs de contraste dans le texte ci-dessus.
En haut, avant correction, le contour bleu #005FCC tombe à 2,98:1 sur le pied de page bleu nuit ; en bas, après correction, la bande claire du contour à deux couleurs y atteint 16,96:1.

Le style à copier :

:root {
  --focus-light: #F9F9F9;
  --focus-dark: #193146;
}
 
:focus-visible {
  outline: 2px solid var(--focus-light);
  outline-offset: 0;
  box-shadow: 0 0 0 4px var(--focus-dark);
}

Pourquoi. L'outline trace la bande claire contre l'élément, et l'ombre trace la bande sombre autour : chaque bande fait 2 px.

À elle seule, chaque bande de 2 px est aussi assez grande pour le critère 2.4.13, du niveau le plus exigeant (AAA). Visez-le dès la maquette : l'équipe ne dessinera le focus qu'une fois.

Pour que le design ne le retire plus, faites entrer l'état de focus dans les maquettes. Précisez ses deux couleurs pour tous les éléments interactifs : une bande claire #F9F9F9 de 2 px contre l'élément, une bande sombre #193146 de 2 px autour.


#Pourquoi un focus en box-shadow disparaît avec le contraste élevé de Windows ?

Quand le contraste élevé de Windows est actif, un focus dessiné avec une ombre seule disparaît, parce que le navigateur supprime toutes les ombres (box-shadow). Ce réglage est un cas du mode couleurs forcées, où le navigateur remplace les couleurs de la page par quelques couleurs choisies par l'utilisateur. Un outline, lui, reste visible dans une couleur du thème : c'est pour cela que le style ci-dessus trace sa bande claire avec l'outline.

Capture d'écran : deux styles de focus sur un bouton, à gauche en couleurs normales, à droite en couleurs forcées. En haut, l'ombre seule disparaît en couleurs forcées ; en bas, l'outline reste.
À gauche en couleurs normales, à droite en couleurs forcées dans Chrome : le focus dessiné en box-shadow seule, en haut, disparaît ; celui qui garde un outline, en bas, reste visible.

Si un composant doit garder un focus en ombre seule, ajoutez outline: 2px solid transparent à son style de focus. Ce contour reste invisible en temps normal et apparaît en couleurs forcées. Évitez aussi d'ajouter une border au focus : elle prend de la place, et le contenu bouge à chaque fois.

Avec Tailwind, la classe ring produit une box-shadow, et disparaît donc en couleurs forcées. La version 4 a en plus changé le sens d'une classe : en v3, outline-none posait un contour transparent, que les couleurs forcées rendaient visible. En v4, ce contour s'appelle outline-hidden, et outline-none supprime tout contour.

Cela veut dire qu'un projet mis à jour à la main vers la v4, qui garde focus:outline-none, perd son focus en couleurs forcées. Associez outline-hidden à chaque ring, ou passez par les classes outline.

En couleurs forcées, tout focus en box-shadow disparaît ; un outline, même transparent, s'affiche, sauf outline-none de Tailwind v4.
Style de focusEn couleurs forcées
outlineReste visible, dans une couleur du thème
box-shadow seuleDisparaît
ring de TailwindDisparaît, comme toute box-shadow
box-shadow avec outline: 2px solid transparentLe contour apparaît, dans une couleur du thème
outline-hidden (Tailwind v4)Le contour apparaît
outline-none (Tailwind v4)Plus aucun indicateur

#Comment tester le focus visible au clavier ?

Sur chaque modèle de page, descendez avec Tab dans l'ordre de tabulation jusqu'au pied de page, puis remontez avec Maj+Tab. Chaque élément doit montrer l'indicateur, et le critère 2.4.11 demande aussi qu'aucun ne disparaisse entièrement sous un en-tête collant, c'est-à-dire fixé en haut de l'écran.

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

Sur le site d'horlogerie, Tab mène jusqu'à « S'inscrire » et Maj+Tab revient : l'anneau de focus à deux couleurs se voit sur fond blanc comme bleu nuit.

Passez ensuite à la souris. Un clic sur un bouton ne fait apparaître aucun anneau, alors qu'un clic dans un champ de texte le montre.

Pour simuler les couleurs forcées dans Chrome, ouvrez les outils de développement, puis le panneau Rendering. Choisissez forced-colors: active et refaites le parcours. Si le site a un thème sombre, recommencez avec prefers-color-scheme: dark.

Sur Mac, Safari demande deux réglages, car Tab ne s'y arrête par défaut que sur les champs et les menus déroulants. Dans ses réglages avancés, réglez Tab pour mettre en évidence chaque élément, puis activez la navigation au clavier dans les réglages Clavier de macOS. Safari ne donne pas non plus le focus à un bouton cliqué : aucun anneau n'y apparaît au clic, quel que soit le CSS.

Avant la mise en ligne, vérifiez :

Le focus peut aussi se poser sur un élément transparent : sur une fiche produit de la démo du thème Shopify Horizon, notée 95 par Lighthouse, le huitième appui sur Tab atteint un bouton invisible.

L'article sur le RGAA 5 montre comment corriger l'en-tête collant en CSS.

RGAA 5 : se conformer avant la sortie de la nouvelle version
Partagez cet article

Questions fréquentes

Les WCAG ne l'exigent pas : elles demandent au moins un mode où le focus est visible, et la navigation au clavier en est un. Le W3C conseille tout de même d'y penser : le focus visible peut aussi aider les personnes qui utilisent la souris.

Le choix dépend de votre public. Un anneau qui n'apparaît pas à chaque fois peut dérouter les personnes peu à l'aise avec l'informatique. Sur un service qui s'adresse à elles, posez le style sur :focus. Dans Chrome, chacun peut aussi le faire apparaître à la souris, avec l'option d'accessibilité « Mettre en surbrillance rapidement l'objet ciblé ».

Non. Un écart entre l'élément et son contour est permis, et il peut rendre l'indicateur plus visible. En CSS, cet écart se règle avec outline-offset.

Le contour (outline) suit l'arrondi fixé par border-radius. Sur un lien coupé sur deux lignes, il entoure les morceaux séparément ou d'un seul tracé, selon le navigateur. Le W3C accepte le tracé séparé pour le critère Apparence du focus.

Le critère 2.4.7, de niveau AA, demande que l'indicateur de focus soit visible. Le 1.4.11, AA lui aussi, exige un contraste de 3:1 entre l'indicateur dessiné par le site et les couleurs qui l'entourent.

Le 2.4.13, de niveau AAA, demande un indicateur au moins aussi grand qu'un trait de 2 px tout autour de l'élément. Ces pixels doivent aussi changer de couleur au focus, avec un contraste de 3:1 entre avant et après. Les deux premiers décident si le site est conforme. Le 2.4.13 sert d'objectif pour la maquette.

Passez l'option focusVisible à la méthode focus() : element.focus({ focusVisible: true }) affiche l'indicateur, et la valeur false l'empêche. Firefox la reconnaît depuis la version 104, Safari depuis la 18.4 et Chrome depuis la 145.

Sans cette option, chaque navigateur applique ses propres règles. Le plus souvent, le nouvel élément fait comme celui qui avait le focus avant lui. Il montre donc l'indicateur après une touche du clavier, et le cache après un clic sur un bouton.

Gardez une indication visible. Dans un de ses exemples, le W3C juge suffisant le curseur qui clignote dans un champ. Au critère 10.7, le RGAA demande que le contour ou le fond change, avec un contraste de 3:1 au moins.

Si le design retire le contour (outline) d'un champ, remplacez-le par une bordure ou un fond qui change au focus et atteint ce seuil.