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
| Touche | event.code | event.key | keyCode | keyCode sur Mac | event.location |
|---|---|---|---|---|---|
| Windows gauche / Commande gauche | MetaLeft | Meta | 91 | 1 (Côté gauche) | |
| Windows droite / Commande droite | MetaRight | Meta | 92 | 93 | 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 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
document.addEventListener('keydown', (event) => {
if (event.key === 'Meta') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'MetaLeft') {
// Votre code ici
}
});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.