tabindex : bien utiliser 0, -1 et les valeurs positives
Autres noms: Index de tabulation, Attribut tabindex, Ordre de tabulation
Définition
tabindex est un attribut HTML qui rend un élément focalisable et fixe sa place dans l’ordre de tabulation. 0 suit l’ordre du code source, -1 n’autorise le focus que par script, et les valeurs positives passent avant tout le reste.
tabindex est un attribut HTML qui détermine si un élément peut recevoir le focus clavier et quelle place il occupe dans l’ordre de tabulation. Avec 0 et -1, c’est un outil précieux pour les contrôles personnalisés et la gestion du focus. Avec des nombres positifs, il réorganise discrètement toute la page pour les utilisateurs du clavier.
Ce que cela signifie
Les liens, les boutons et les champs de formulaire sont focalisables par défaut, dans l’ordre où ils apparaissent dans le code source. L’attribut tabindex modifie ce comportement :
| Valeur | Effet | Usage typique |
|---|---|---|
| aucune | Comportement natif du focus | Liens, boutons, champs : rien à ajouter |
tabindex="0" |
Focalisable, dans l’ordre du code source | Un contrôle personnalisé ou une zone défilante qui doit être atteignable |
tabindex="-1" |
Focalisable uniquement par script ou par clic, ignoré par Tab | Un titre de boîte de dialogue ou un récapitulatif d’erreurs vers lequel vous déplacez le focus |
tabindex="1" ou plus |
Reçoit le focus avant tous les autres éléments, par ordre numérique croissant | Presque jamais : cela casse l’ordre naturel |
La règle qui s’applique est le critère WCAG 2.4.3 Parcours du focus, de niveau A : si une page peut être parcourue de façon séquentielle et que l’ordre a une incidence sur la signification ou l’utilisation, les composants focalisables doivent recevoir le focus dans un ordre qui préserve la signification et l’opérabilité. Le W3C répertorie le cas d’échec F44 : utiliser tabindex pour créer un ordre de tabulation qui ne préserve pas la signification et l’opérabilité. L’alternative recommandée est la technique C27 : faire correspondre l’ordre du DOM à l’ordre visuel, ce qui évite tout tabindex. Pour en savoir plus sur le parcours du focus lui-même, consultez son article.
Qui est concerné : les personnes qui utilisent la navigation au clavier, les utilisateurs de lecteurs d’écran qui passent d’un contrôle à l’autre, et les personnes qui se servent de contacteurs. Un mauvais ordre de tabulation leur fait manquer des champs, perdre le fil ou remplir un formulaire dans le mauvais ordre.
Exemples
Un interrupteur personnalisé qui a besoin de tabindex="0", un titre de boîte de dialogue qui reçoit le focus par script, et la valeur positive à éviter :
<!-- Custom control: reachable in source order -->
<div role="switch" aria-checked="false" tabindex="0">Dark theme</div>
<!-- Focus target for script, not a Tab stop -->
<h2 id="dialog-title" tabindex="-1">Confirm your order</h2>
<script>document.getElementById('dialog-title').focus();</script>
<!-- Avoid: jumps ahead of everything else on the page -->
<input type="email" name="newsletter" tabindex="3">Lorsque le focus entre dans une boîte de dialogue, il doit y rester jusqu’à sa fermeture – voir boîte de dialogue modale accessible.
Utilisez d’abord les éléments natifs : ils sont focalisables sans tabindex. Utilisez tabindex="0" pour les contrôles personnalisés et les zones défilantes, tabindex="-1" pour les éléments auxquels vous donnez le focus par script. Corrigez les problèmes de mise en page dans l’ordre du code source. Donnez à chaque élément focalisable un indicateur de focus visible.
Utiliser des valeurs positives pour « corriger » une mise en page. Mettre tabindex="0" sur du texte ou des titres non interactifs : cela ajoute des arrêts de tabulation inutiles. Donner tabindex="-1" à un élément qui a l’apparence d’un élément cliquable et l’exclure ainsi du parcours au clavier.
Comment vérifier tabindex
Questions fréquentes
Quelle est la différence entre tabindex 0 et -1 ?
tabindex="0" place un élément dans la séquence normale de tabulation, à sa place dans le code source. tabindex="-1" le rend focalisable par script ou par clic de souris, mais la touche Tab l’ignore : c’est utile pour les titres ou les messages vers lesquels vous déplacez le focus.
Pourquoi éviter les valeurs positives de tabindex ?
Les éléments dotés d’un index de tabulation positif reçoivent le focus avant tous les autres, par ordre numérique, où qu’ils se trouvent dans la page. Cela crée facilement un ordre qui ne préserve pas la signification, le cas d’échec que le W3C décrit sous le code F44 pour le critère WCAG 2.4.3.
Les boutons et les liens ont-ils besoin d’un tabindex ?
Non. Les liens natifs avec un href, les boutons et les champs de formulaire sont déjà focalisables dans l’ordre du code source. Ajouter tabindex="0" n’y change rien ; ajouter une valeur positive aggrave l’ordre.
Quelles lois exigent un ordre de tabulation correct ?
Le critère 2.4.3 est de niveau A : il fait donc partie de toute norme fondée sur les WCAG AA, y compris l’article 9.2.4.3 de la norme EN 301 549, sur laquelle s’appuie l’acte européen sur l’accessibilité.
allyWay peut-il corriger tabindex automatiquement ?
Oui. allyWay remplace chaque tabindex supérieur à 0 par 0, pour que la touche Tab suive de nouveau l’ordre de la page, gratuitement, sans utiliser de corrections par IA et sans modification de votre code ou de votre thème. Avant la mise en ligne de la correction, allyWay l’essaie sur votre vraie page et ne l’applique que si rien de ce que voient vos visiteurs ne change ; vous pouvez l’annuler en un clic. Commencez gratuitement et obtenez un ordre de tabulation logique sur chaque page.
Termes associés
Parcours du focus : ordre de tabulation logique (WCAG 2.4.3)
Le parcours du focus est l’ordre dans lequel les éléments interactifs reçoivent le focus clavier lorsqu’un utilisateur appuie sur Tab. Le critère WCAG 2.4.3 exige que cet ordre préserve la signification et l’opérabilité de la page.
Lire la définition: Parcours du focus : ordre de tabulation logique (WCAG 2.4.3)Navigation au clavier : le critère WCAG 2.1.1 expliqué
La navigation au clavier signifie que chaque fonction d’un site web peut être atteinte et utilisée uniquement au clavier, généralement avec Tab, Maj+Tab, Entrée, Espace et les touches fléchées. Le critère WCAG 2.1.1 l’exige au niveau A.
Lire la définition: Navigation au clavier : le critère WCAG 2.1.1 expliquéVisibilité du focus : WCAG 2.4.7 et styles de focus visibles
La visibilité du focus signifie qu’un site web affiche un indicateur visible, généralement un contour, sur le lien, le bouton ou le champ qui a le focus clavier. Le critère WCAG 2.4.7 l’exige au niveau AA.
Lire la définition: Visibilité du focus : WCAG 2.4.7 et styles de focus visiblesBoîte de dialogue modale accessible : focus, Échap, ARIA
Une boîte de dialogue modale accessible est une fenêtre contextuelle que les utilisateurs du clavier et des lecteurs d’écran peuvent utiliser comme tout le monde : le focus y entre à l’ouverture, la page en arrière-plan est inerte, la touche Échap la ferme et le focus revient à la commande qui l’a ouverte. Sa gestion du focus relève du critère WCAG 2.4.3 Parcours du focus, de niveau A.
Lire la définition: Boîte de dialogue modale accessible : focus, Échap, ARIA