CKTIS / JavaScript
HTMLElement.tabIndex — focus et ordre de navigation
La propriété tabIndex reflète l’attribut tabindex et influence la possibilité de recevoir le focus ainsi que l’ordre de navigation au clavier.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.tabIndex;
element.tabIndex = integer;HTMLElement.tabIndex lit un entier ; une affectation écrit dans l’attribut tabindex. En l’absence de valeur valide, la valeur lue par défaut dépend de l’élément : 0 pour button, mais -1 pour div.
0 indique que l’élément devrait figurer dans l’ordre de tabulation habituel, sans garantir que la touche Tab permet de l’atteindre. Une valeur négative l’exclut normalement de cet ordre, sans empêcher focus() de lui donner le focus s’il est par ailleurs en mesure de le recevoir. Aucune de ces deux valeurs ne permet de donner le focus à un élément inerte ou non rendu, ni à un contrôle de formulaire désactivé. Les préférences de l’utilisateur peuvent aussi influer sur la navigation avec la touche Tab. Les valeurs positives définissent une priorité au sein d’un même périmètre de navigation ; privilégiez 0 et -1.
La valeur lue ne prouve pas à elle seule que l’élément peut recevoir le focus. Affecter -1 ne supprime pas l’attribut ; utilisez removeAttribute('tabindex').
Exemples
const element = document.createElement('div');
const report = () => console.log(JSON.stringify([
element.tabIndex,
element.getAttribute('tabindex')
]));
report();
element.tabIndex = 0;
report();
element.tabIndex = -1;
report();
element.removeAttribute('tabindex');
report();Résultat
[-1,null] [0,"0"] [-1,"-1"] [-1,null]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.