tabindex

tabindex ne devrait pas être supérieur à 0

manualconfiance : mediumgravité : minoroperable

Vérifie que les valeurs de tabindex sont nulles ou négatives, et non un nombre positif.

Applicabilité. S’applique aux éléments dotés d’un attribut tabindex dont la valeur s’analyse comme un entier valide.

Attendu. La valeur de tabindex est 0 ou négative. Un tabindex positif réordonne explicitement l’ordre de tabulation au clavier, ce qui est fragile à maintenir au fil des évolutions de la page et indique généralement qu’il faudrait plutôt corriger l’ordre naturel du DOM.

Ce que rapporte un constat.

  • value : la valeur tabindex, un nombre entier supérieur à 0.

Ces champs de data.details aident à lire et à reproduire un constat. À part reasonCode et les quelques champs que la page Schéma de sortie donne comme stables, ils ne constituent pas un contrat stable : un champ peut être renommé ou supprimé dans une version mineure, ne vous appuyez donc pas dessus.

Exemples

pass
<div tabindex="0">Focusable</div>

tabindex="0" place l’élément dans l’ordre de tabulation naturel sans rien réordonner.

can't tell
<div tabindex="3">Reordered</div>

Un tabindex positif sort cet élément de l’ordre de tabulation naturel du document et le place devant tout le reste, ce qui surprend généralement les utilisateurs du clavier.

Comment vérifier

Quand cette règle ne peut pas trancher, elle renvoie cantTell et laisse la question à une personne. Chaque question qu’elle peut poser figure ici sous son code de raison, avec les étapes pour y répondre. Un constat porte les mêmes étapes dans howToCheck, dans la langue de l’analyse. Voir Schéma de sortie.

TABINDEX_POSITIVE

  1. Cliquez juste avant le début de la page, puis appuyez plusieurs fois sur Tab en observant le contour de focus.
  2. Notez à quel moment l’élément indiqué par le rapport reçoit le focus, par rapport à sa position à l’écran.
  3. Vérifiez si l’ordre du focus suit toujours l’ordre visuel et l’ordre de lecture de la page.

Réussite. Le focus parcourt la page dans un ordre qui correspond à sa mise en page et à son sens.

Échec. Le tabindex positif fait sauter le focus hors de l’ordre de lecture, ce qui peut ne pas respecter le critère WCAG 2.4.3 (F44) et va à l’encontre des bonnes pratiques.

Voir le code source