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
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Flèche gauche | ArrowLeft | ArrowLeft | 37 | 0 (Standard) |
| Flèche haut | ArrowUp | ArrowUp | 38 | 0 (Standard) |
| Flèche droite | ArrowRight | ArrowRight | 39 | 0 (Standard) |
| Flèche bas | ArrowDown | ArrowDown | 40 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'ArrowLeft') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'ArrowLeft') {
// Votre code ici
}
});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.