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
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Tab | Tab | Tab | 9 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Tab') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Tab') {
// Votre code ici
}
});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.