Codes des touches fléchées

Les flèches envoient event.key « ArrowLeft », « ArrowUp », « ArrowRight » et « ArrowDown », et keyCode 37, 38, 39 et 40.

Toutes les valeurs d’un coup d’œil

Valeurs pour Touches fléchées
Toucheevent.codeevent.keykeyCodeevent.location
Flèche gaucheArrowLeftArrowLeft370 (Standard)
Flèche hautArrowUpArrowUp380 (Standard)
Flèche droiteArrowRightArrowRight390 (Standard)
Flèche basArrowDownArrowDown400 (Standard)

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 une touche fléchée

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

Code pour réagir à Flèche gauche

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

Quelle valeur utiliser

Vérifiez event.key. Les flèches ne changent pas selon la disposition du clavier : key et code ont les mêmes noms, ArrowLeft, ArrowUp, ArrowRight et ArrowDown.

Utilisez event.code quand le pavé numérique ne doit pas compter. Avec Verr. num désactivé, les touches 4, 8, 6 et 2 du pavé numérique envoient aussi key « ArrowLeft », « ArrowUp », « ArrowRight » et « ArrowDown » et keyCode 37 à 40. Seuls leur code (Numpad4, Numpad8, Numpad6, Numpad2) et location 3 les trahissent.

Les anciens numéros tournent depuis la gauche : 37 gauche, 38 haut, 39 droite, 40 bas. Tous les navigateurs les envoient encore, mais ils sont obsolètes.

Ce qui pose problème

La page défile quand le joueur appuie sur une flèche

Le défilement est l’action par défaut des flèches. Appelez event.preventDefault() dans keydown. Écoutez sur le jeu lui-même (donnez-lui tabindex="0") plutôt que sur window, pour que le reste de la page défile encore et que les champs de texte déplacent encore le curseur :

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

Le mouvement saccade, ou une direction reste bloquée

Une touche maintenue envoie un keydown, puis une pause, puis se répète à la vitesse de répétition de l’utilisateur. Bouger à chaque keydown saccade. Gardez plutôt un ensemble de touches maintenues : ajoutez event.code sur keydown, retirez-le sur keyup, et gérez le déplacement dans la boucle de votre jeu. Videz l’ensemble sur l’événement blur de la fenêtre : si l’utilisateur change de fenêtre en maintenant une touche, son keyup n’arrive jamais à votre page.

Un ancien code vérifie « Left » ou « Up »

Internet Explorer, Edge 16 et les versions plus anciennes, et Firefox 36 et les versions plus anciennes envoyaient "Left", "Up", "Right" et "Down". Les navigateurs actuels envoient les noms en Arrow. Vérifiez les deux seulement si vous gérez encore ces navigateurs.

Votre gestionnaire de flèches entre en conflit avec un curseur de réglage, une liste ou un champ de texte

Beaucoup d’éléments utilisent eux-mêmes les flèches : les champs de texte déplacent le curseur, les curseurs de réglage changent leur valeur, les boutons radio et <select> changent le choix. Ignorez les événements dont event.target est l’un d’eux, ou laissez-les traiter la touche d’abord et vérifiez event.defaultPrevented.

Claviers de Mac et d’ordinateur portable

Les Mac portables et beaucoup de petits claviers n’ont pas de touches Début, Fin, Page précédente ou Page suivante. Sur un Mac, maintenez plutôt Fn avec une flèche : Fn + Gauche envoie Home, Fn + Droite End, Fn + Haut Page Up et Fn + Bas Page Down. La page reçoit ces touches, pas une flèche.

Sur un Mac, le keyup d’une flèche appuyée pendant que Commande est maintenue peut ne pas arriver, quel que soit le navigateur. Ne vous y fiez pas pour l’état des touches maintenues.