Codes des touches de lettres (A à Z)
Les touches de lettres envoient event.code « KeyA » à « KeyZ », event.key « a » à « z » sur une disposition américaine (« A » à « Z » avec Maj ou Verr. maj) et keyCode 65 à 90.
Toutes les valeurs d’un coup d’œil
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| A | KeyA | a | 65 | 0 (Standard) |
| B | KeyB | b | 66 | 0 (Standard) |
| C | KeyC | c | 67 | 0 (Standard) |
| D | KeyD | d | 68 | 0 (Standard) |
| E | KeyE | e | 69 | 0 (Standard) |
| F | KeyF | f | 70 | 0 (Standard) |
| G | KeyG | g | 71 | 0 (Standard) |
| H | KeyH | h | 72 | 0 (Standard) |
| I | KeyI | i | 73 | 0 (Standard) |
| J | KeyJ | j | 74 | 0 (Standard) |
| K | KeyK | k | 75 | 0 (Standard) |
| L | KeyL | l | 76 | 0 (Standard) |
| M | KeyM | m | 77 | 0 (Standard) |
| N | KeyN | n | 78 | 0 (Standard) |
| O | KeyO | o | 79 | 0 (Standard) |
| P | KeyP | p | 80 | 0 (Standard) |
| Q | KeyQ | q | 81 | 0 (Standard) |
| R | KeyR | r | 82 | 0 (Standard) |
| S | KeyS | s | 83 | 0 (Standard) |
| T | KeyT | t | 84 | 0 (Standard) |
| U | KeyU | u | 85 | 0 (Standard) |
| V | KeyV | v | 86 | 0 (Standard) |
| W | KeyW | w | 87 | 0 (Standard) |
| X | KeyX | x | 88 | 0 (Standard) |
| Y | KeyY | y | 89 | 0 (Standard) |
| Z | KeyZ | z | 90 | 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 de lettre
Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.
Code pour réagir à A
document.addEventListener('keydown', (event) => {
if (event.key === 'a') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'KeyA') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 65) {
// Votre code ici
}
});Quelle valeur utiliser
Cela dépend de ce qui compte : la lettre ou la place de la touche sur le clavier.
Pour les lettres tapées et les raccourcis qui portent le nom d’une lettre, comme Ctrl + Z pour annuler, vérifiez event.key. Cette valeur suit la disposition de l’utilisateur : le raccourci marche sur la touche qui affiche un Z.
Pour les touches choisies selon leur place, comme WASD dans un jeu, vérifiez event.code. KeyW est la touche au-dessus de S sur toutes les dispositions, même sur un clavier français AZERTY où elle tape « z ».
keyCode est le numéro de la lettre majuscule, 65 pour A jusqu’à 90 pour Z, avec ou sans Maj. Sur les dispositions latines, il suit en général la lettre tapée : sur AZERTY, la touche de code KeyQ tape « a » et envoie 65. Sur les dispositions russes, grecques et autres dispositions non latines, c’est en général la lettre américaine à cet endroit.
Ce qui pose problème
event.key vaut « A » au lieu de « a »
Maj et Verr. maj changent event.key. Comparez en minuscules, event.key.toLowerCase() === 'a', et vérifiez event.shiftKey à part si Maj compte. Cela aide aussi sur Mac, où Commande + Maj + Z peut arriver sous la forme d’un « z » minuscule.
Les commandes WASD ne marchent pas sur un clavier français
Si vous vérifiez event.key === 'w', les joueurs sur AZERTY doivent aller chercher le W en bas à gauche. Vérifiez event.code (KeyW, KeyA, KeyS, KeyD) pour que les touches restent au même endroit. Pour afficher les bonnes lettres dans votre aide, Chrome et Edge peuvent vous dire ce que tape un code : navigator.keyboard.getLayoutMap().
Ctrl+Z tombe sur la mauvaise touche sur un clavier allemand ou français
Le QWERTZ allemand échange Z et Y, et sur AZERTY le Z est là où se trouve le W d’un clavier américain. Un raccourci vérifié avec event.code === 'KeyZ' oblige les utilisateurs allemands à appuyer sur la touche marquée Y. Comparez les raccourcis de lettres avec event.key.
Les raccourcis ne marchent plus sur une disposition russe ou grecque
Sur ces dispositions, event.key est la lettre de cet alphabet : Ctrl + Z sur une disposition russe envoie « я ». Revenez à la place de la touche quand ce n’est pas une lettre latine :
const letter = /^[a-z]$/i.test(event.key)
? event.key.toLowerCase()
: event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';Alt+lettre tape un caractère sur un Mac
Option + S tape « ß », donc event.key vaut « ß », pas « s ». Option + E est une touche morte : event.key vaut « Dead » et la lettre suivante reçoit l’accent. Comparez les raccourcis avec Alt grâce à event.code et event.altKey. Sous Windows, les dispositions avec Alt Gr font la même chose avec Ctrl + Alt : Ctrl + Alt + E tape € sur un clavier allemand, évitez donc les raccourcis Ctrl + Alt + lettre.