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

Valeurs pour Maj
Toucheevent.codeevent.keykeyCodeevent.location
Maj gaucheShiftLeftShift161 (Côté gauche)
Maj droiteShiftRightShift162 (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

Recommandé : reconnaître event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'Shift') {
    // Votre code ici
  }
});
Reconnaître la place de la touche : event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ShiftLeft') {
    // Votre code ici
  }
});
Ancien code qui utilise encore keyCode (obsolète)
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.