Code de la touche Tab

Tab envoie event.key « Tab », event.code « Tab » et keyCode 9, avec ou sans Maj.

Toutes les valeurs d’un coup d’œil

Valeurs pour Tab
Toucheevent.codeevent.keykeyCodeevent.location
TabTabTab90 (Standard)

keyCode tel que Chrome et Edge l’envoient sous Windows. La colonne Mac (Chrome et Safari sur Mac) et la colonne Firefox n’affichent que les nombres qui diffèrent. Certaines touches diffèrent aussi selon le système, comme le dit le texte plus bas. event.which est toujours le même nombre que keyCode. event.key correspond à une disposition américaine sans Maj.

Appuyez dessus ici

Cliquez ici, puis appuyez sur Tab

Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.

Code pour réagir à Tab

Recommandé : reconnaître event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Tab') {
    // Votre code ici
  }
});
Reconnaître la place de la touche : event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Tab') {
    // Votre code ici
  }
});
Ancien code qui utilise encore keyCode (obsolète)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 9) {
    // Votre code ici
  }
});

Quelle valeur utiliser

Vérifiez event.key === 'Tab'. Il n’y a qu’une touche Tab, et elle envoie la même valeur sur toutes les dispositions. event.code vaut aussi "Tab".

Maj + Tab envoie toujours "Tab" : Maj ne change pas le nom de la touche. Vérifiez event.shiftKey pour distinguer les deux.

keyCode 9 arrive encore dans tous les navigateurs, mais il est obsolète.

Ce qui pose problème

Le keyup arrive sur un autre élément

Tab déplace le focus au keydown. Le keydown va donc au champ que vous quittez et le keyup va au champ où vous arrivez. Un gestionnaire keyup sur un champ voit Tab chaque fois que quelqu’un y arrive avec Tab. Gérez Tab au keydown.

Les utilisateurs du clavier sont bloqués dans mon composant

Si vous appelez preventDefault() sur Tab, le focus ne bouge jamais, et les utilisateurs du clavier ne peuvent pas sortir. Sans autre issue, cela ne respecte pas le critère WCAG 2.1.2, Pas de piège au clavier. N’arrêtez Tab que pour une bonne raison, comme une boîte de dialogue modale qui garde le focus à l’intérieur tant qu’elle est ouverte. Donnez alors une sortie claire : Échap, ou un bouton de fermeture.

Dans mon textarea, Tab quitte le champ au lieu de mettre une tabulation

C’est le comportement par défaut, et la plupart des utilisateurs le veulent. Dans un éditeur de code, vous pouvez insérer une tabulation à la place :

if (event.key === 'Tab' && !event.shiftKey) {
  event.preventDefault();
  textarea.setRangeText('\t', textarea.selectionStart, textarea.selectionEnd, 'end');
}

Ajoutez une sortie, comme le fait l’outil keycode : appuyez d’abord sur Échap, puis Tab passe au suivant. setRangeText() n’ajoute rien à l’historique d’annulation ; document.execCommand('insertText', false, '\t') le fait, mais il est obsolète.

Ctrl+Tab et Alt+Tab n’arrivent jamais à la page

Le navigateur et l’ordinateur les gardent : Ctrl + Tab change d’onglet dans le navigateur, Alt + Tab (Commande + Tab sur un Mac) change d’application. Votre page peut voir le keydown de Ctrl ou d’Alt, puis plus rien. Quand l’utilisateur revient, une touche de modification peut sembler bloquée, car son keyup est allé à une autre fenêtre. Réinitialisez l’état des touches de modification sur l’événement blur de la fenêtre.

Dans Safari, Tab saute les liens et les boutons

Par défaut, Safari sur Mac ne passe que d’un champ de formulaire à l’autre. Option + Tab atteint tous les éléments, ou activez « Appuyer sur Tab pour mettre en surbrillance chaque élément d’une page web » dans les réglages de Safari. Testez votre ordre de tabulation avec cette option, et ne supposez pas que les utilisateurs de Mac atteignent un bouton avec Tab seule.

Ordre de tabulation

Tab suit l’ordre des éléments dans le HTML. tabindex="0" ajoute un élément à cet ordre et tabindex="-1" l’en retire. Évitez les nombres positifs : ils passent devant tout le reste et déroutent les gens.