Code de la touche Maj (Shift)
Les deux touches Maj envoient event.key « Shift » et keyCode 16. Seuls event.code et event.location distinguent la gauche de la droite.
Toutes les valeurs d’un coup d’œil
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Maj gauche | ShiftLeft | Shift | 16 | 1 (Côté gauche) |
| Maj droite | ShiftRight | Shift | 16 | 2 (Côté droit) |
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 Maj
Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.
Code pour réagir à Maj gauche
document.addEventListener('keydown', (event) => {
if (event.key === 'Shift') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ShiftLeft') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 16) {
// Votre code ici
}
});Quelle valeur utiliser
Pour savoir si Maj est maintenue pendant une autre touche, vérifiez event.shiftKey. Il vaut true sur chaque événement de touche tant que l’une des deux touches Maj est enfoncée : vous n’avez pas à suivre la touche Maj vous-même.
Pour réagir à Maj elle-même, vérifiez event.key === 'Shift'. Les deux touches l’envoient, avec keyCode 16. Utilisez event.code (ShiftLeft ou ShiftRight) ou event.location (1 gauche, 2 droite) quand les deux touches doivent faire des choses différentes.
Sur les événements de la touche Maj elle-même, shiftKey vaut true au keydown et false au keyup, car il indique l’état après l’appui ou le relâchement.
Ce qui pose problème
Ctrl+Maj+Z ne correspond pas à event.key === ‘z’
Maj change l’event.key de l’autre touche : « z » devient « Z », « 1 » devient « ! ». Elle ne change pas event.code (KeyZ, Digit1) ni keyCode (90, 49). Pour les raccourcis de lettres avec Maj, comparez en minuscules ou utilisez code :
if (event.ctrlKey && event.shiftKey && event.key.toLowerCase() === 'z') redo();Maj+2 tape @ pour vous mais “ pour quelqu’un d’autre
Le symbole d’une touche Maj + chiffre dépend de la disposition : Maj + 2 donne « @ » sur un clavier américain et « “ » sur un britannique, et AZERTY demande Maj pour taper les chiffres eux-mêmes. Si votre raccourci est un symbole, vérifiez event.key pour le symbole et ignorez shiftKey. Si c’est une position de touche, vérifiez event.code.
Une touche Maj reste « maintenue » après un appui sur les deux
Sous Windows, quand les deux touches Maj sont enfoncées, le système peut ne signaler qu’un seul relâchement : le keyup d’une des touches Maj peut donc manquer. Si vous suivez chaque côté, réinitialisez les deux dès qu’un keyup de Maj arrive, ou vérifiez event.shiftKey au prochain événement de touche pour corriger votre état.
Maj maintenue pendant que la fenêtre perd le focus
Le keyup va alors à une autre fenêtre. Réinitialisez votre état de Maj sur l’événement blur de la fenêtre, ou fiez-vous à event.shiftKey au prochain événement de touche ou de souris plutôt qu’à votre propre indicateur.
Maj avec la souris et sur téléphone
Les événements de souris et de pointeur portent aussi shiftKey : Maj + clic (sélectionner une plage) n’a donc pas besoin d’écouteur de touche. N’attendez pas d’événement de touche Maj depuis le clavier à l’écran d’un téléphone : Android signale souvent les touches avec keyCode 229, et la lettre majuscule arrive simplement comme du texte.