Code de la touche Meta (touche Windows et Commande)

La touche Windows et la touche Commande envoient event.key « Meta ». keyCode vaut 91 pour la touche de gauche, mais la touche de droite et Firefox sur Mac donnent d’autres valeurs.

Toutes les valeurs d’un coup d’œil

Valeurs pour Touche Windows / Commande (Meta)
Toucheevent.codeevent.keykeyCodekeyCode sur Macevent.location
Windows gauche / Commande gaucheMetaLeftMeta911 (Côté gauche)
Windows droite / Commande droiteMetaRightMeta92932 (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 la touche Windows ou Commande

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

Code pour réagir à Windows gauche

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

Quelle valeur utiliser

Pour les raccourcis Mac, vérifiez event.metaKey au keydown de l’autre touche. Il vaut true tant que Commande (ou la touche Windows) est maintenue. Combinez-le avec ctrlKey pour les raccourcis qui doivent marcher sur les deux systèmes.

Pour réagir à la touche elle-même, vérifiez event.key === 'Meta', ou event.code : MetaLeft ou MetaRight. Les mêmes noms couvrent la touche Windows, la touche Commande du Mac et la touche Super sous Linux.

N’utilisez pas keyCode pour cette touche. La touche de gauche vaut 91, mais Firefox sur Mac envoie 224 pour les deux touches, Firefox sous Windows et Linux envoie 91 pour les deux, et la touche de droite vaut 92 sous Windows mais 93 dans Chrome et Safari sur Mac.

Ce qui pose problème

Sur un Mac, le keyup n’arrive jamais pour les touches pressées avec Commande maintenue

macOS n’envoie pas le keyup des touches pressées pendant que Commande est maintenue : appuyez sur Commande + K, relâchez K, et la page ne reçoit aucun keyup pour K. Les navigateurs ne peuvent pas tout corriger, car macOS ne signale pas le relâchement. Ne suivez pas les touches maintenues à travers les raccourcis Commande. Quand le keyup de Meta arrive, marquez comme relâchées les touches pressées pendant que Commande était maintenue.

keyCode 93 désigne deux touches différentes

Sous Windows, 93 est la touche de menu (event.code « ContextMenu »). Dans Chrome et Safari sur Mac, 93 est la touche Commande de droite. Utilisez event.code pour savoir laquelle vous avez reçue.

La touche Windows ouvre le menu Démarrer à la place

La touche Windows seule ouvre le menu Démarrer, et les raccourcis Windows comme Windows + D, Windows + L ou Windows + Tab vont au système. La page ne peut pas les arrêter. Le menu Démarrer prend le focus : des keyup peuvent donc manquer. Réinitialisez les touches maintenues sur l’événement blur de la fenêtre. Ne créez pas de raccourcis avec la touche Windows.

Les anciens Firefox envoient « OS » et « OSLeft »

Avant la version 118, Firefox envoyait event.key « OS » pour la touche Windows, et event.code « OSLeft » et « OSRight ». Avant la version 52, Chrome utilisait « OSLeft » et « OSRight ». Les navigateurs actuels envoient "Meta", "MetaLeft" et "MetaRight". Ne vérifiez les anciens noms que si vous gérez ces versions.

Raccourcis Commande sur un Mac

Les utilisateurs de Mac s’attendent à Commande là où Windows utilise Ctrl : Commande + S pour enregistrer, Commande + Z pour annuler, Commande + Maj + Z pour rétablir. Acceptez event.ctrlKey || event.metaKey, et nommez le raccourci Commande + S ou ⌘S sur un Mac. Commande + N, Commande + T, Commande + W et Commande + Q appartiennent au navigateur et n’arrivent jamais à la page.