# tabindex : bien utiliser 0, -1 et les valeurs positives

Source: https://allyway.ai/fr/glossary/tabindex

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](https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html), 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](https://allyway.ai/fr/glossary/parcours-du-focus) lui-même, consultez son article.

> **Warning:** > **Une seule valeur positive touche toute la page**
> Un seul `tabindex="1"` sur un champ de newsletter dans le pied de page en fait le premier arrêt après la barre d’adresse du navigateur, avant le logo, le menu et votre [lien d’évitement](https://allyway.ai/fr/glossary/lien-d-evitement). Tous les éléments dotés d’un index de tabulation positif sont visités en premier, puis le reste de la page.

Qui est concerné : les personnes qui utilisent la [navigation au clavier](https://allyway.ai/fr/glossary/navigation-au-clavier), les utilisateurs de [lecteurs d’écran](https://allyway.ai/fr/glossary/lecteur-d-ecran) 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 :

```html title="Exemple"
<!-- 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](https://allyway.ai/fr/glossary/boite-de-dialogue-modale-accessible).

**Do:** À faire

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](https://allyway.ai/fr/glossary/visibilite-du-focus).

**Don't:** À éviter

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

Q: Quelle est la différence entre tabindex 0 et -1 ?
A: `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.

Q: Pourquoi éviter les valeurs positives de tabindex ?
A: 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.

Q: Les boutons et les liens ont-ils besoin d’un tabindex ?
A: 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.

Q: Quelles lois exigent un ordre de tabulation correct ?
A: 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é](https://allyway.ai/fr/regulations/eaa).

Q: allyWay peut-il corriger tabindex automatiquement ?
A: 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](https://app.allyway.ai/register) et obtenez un ordre de tabulation logique sur chaque page.
