Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

terme ou valeur HTML: tabindex

L’attribut `tabindex` contrôle la capacité à recevoir le focus et la participation à la navigation séquentielle au clavier.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<div tabindex="-1">…</div>

tabindex accepte un entier valide. 0 exprime la préférence de l’auteur pour une inclusion selon structure et portée, tandis que -1 préfère le focus par script ou clic sans participation à Tab ; l’agent utilisateur peut ignorer ces préférences selon les conventions de la plate-forme.

La propriété tabIndex expose la valeur DOM et focus() peut focaliser un élément de valeur négative. Aucune valeur tabindex ne rend non focalisable un élément intrinsèquement focalisable ; employez disabled pour un contrôle ou inert pour un sous-arbre lorsque cette sémantique convient.

Évitez les valeurs positives comme tabindex="1", qui créent un ordre distinct difficile à maintenir. Les éléments natifs button et a avec adresse ont déjà un clavier ; rendre un div focalisable ne lui donne ni rôle ni activation par Entrée ou Espace.

L’exemple donne au conteneur tabindex="-1" : la propriété renvoie -1 et, après focus(), l’élément devient document.activeElement bien qu’il ne participe pas à la séquence Tab ordinaire.

Exemples

<!doctype html><meta charset="utf-8"><button id="a">A</button><div id="x" tabindex="-1">Target</div><output id="result"></output><script>x.focus();result.textContent=`tabIndex=${x.tabIndex}; focused=${document.activeElement===x}`;</script>

Résultat

tabIndex=-1; focused=true

L’exemple exécuté vérifie la frontière entre focus programmé et navigation séquentielle pour une valeur négative.

Sources