Code de la touche Ctrl

Les deux touches Ctrl envoient event.key « Control » et keyCode 17. Seuls event.code et event.location distinguent la gauche de la droite.

Toutes les valeurs d’un coup d’œil

Valeurs pour Ctrl
Toucheevent.codeevent.keykeyCodeevent.location
Ctrl gaucheControlLeftControl171 (Côté gauche)
Ctrl droiteControlRightControl172 (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 Ctrl

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

Code pour réagir à Ctrl gauche

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

Quelle valeur utiliser

Pour les raccourcis, vérifiez event.ctrlKey sur le keydown de l’autre touche. Il est vrai tant qu’une des deux touches Ctrl est maintenue : vous n’avez pas à suivre Ctrl vous-même.

Pour réagir à Ctrl elle-même, vérifiez event.key === 'Control'. Les deux touches l’envoient, avec keyCode 17. Utilisez event.code (ControlLeft ou ControlRight) ou event.location (1 gauche, 2 droite) pour les distinguer. Beaucoup d’ordinateurs portables n’ont pas de Ctrl droite du tout.

Sur un Mac, la touche marquée control envoie les mêmes valeurs. Mais les raccourcis du Mac utilisent Commande, qui est metaKey, pas ctrlKey.

Ce qui pose problème

Le raccourci marche sous Windows mais pas sur un Mac

Les utilisateurs de Mac appuient sur Commande + S, pas sur Ctrl + S. Acceptez les deux :

if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
  event.preventDefault();
  save();
}

Affichez aussi la bonne indication : Ctrl + S sous Windows et Linux, Commande + S ou ⌘S sur un Mac.

Ctrl se déclenche quand l’utilisateur écrit @ ou € avec Alt Gr

Sous Windows, Alt Gr fonctionne comme Ctrl et Alt ensemble. Chrome et Edge envoient d’abord un keydown de Ctrl gauche, puis Alt droite, et ctrlKey et altKey sont tous deux vrais sur la touche saisie. Un raccourci Ctrl + Alt + lettre peut alors se déclencher quand un utilisateur polonais écrit « ą » ou un utilisateur allemand écrit « @ ». Évitez les raccourcis Ctrl + Alt, ou ignorez les touches dont event.key est un caractère autre que la lettre attendue.

Ctrl+W, Ctrl+T, Ctrl+N ou Ctrl+Tab ne peuvent pas être arrêtés

Le navigateur les garde : Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page précédente et Ctrl + Page suivante sous Windows. Dans Chrome et Edge, la page ne reçoit aucun keydown ; Firefox peut envoyer le keydown, mais dans les deux cas, preventDefault() ne peut pas arrêter le navigateur. Choisissez d’autres raccourcis. Ctrl + S, Ctrl + P et Ctrl + F arrivent bien, et preventDefault() arrête l’action propre du navigateur.

Ctrl+clic ouvre un menu sur un Mac

Sur un Mac, Control + clic est un clic droit : le navigateur déclenche contextmenu. N’utilisez pas Ctrl + clic pour « ajouter à la sélection » sur un Mac ; utilisez-y Commande + clic (metaKey), comme les applications du Mac.

Ctrl+molette zoome la page

Ctrl avec la molette de la souris zoome, tout comme un pincement sur le pavé tactile, que Chrome, Edge et Firefox envoient comme un événement de molette avec Ctrl. Un écouteur wheel voit ctrlKey vrai ; n’appelez preventDefault() dessus que si votre carte ou votre canvas gère son propre zoom, et enregistrez-le avec { passive: false }.