Codes des touches numériques (0 à 9)
Les touches de chiffres au-dessus des lettres envoient event.code « Digit0 » à « Digit9 », event.key « 0 » à « 9 » sur une disposition américaine et keyCode 48 à 57.
Toutes les valeurs d’un coup d’œil
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| 0 | Digit0 | 0 | 48 | 0 (Standard) |
| 1 | Digit1 | 1 | 49 | 0 (Standard) |
| 2 | Digit2 | 2 | 50 | 0 (Standard) |
| 3 | Digit3 | 3 | 51 | 0 (Standard) |
| 4 | Digit4 | 4 | 52 | 0 (Standard) |
| 5 | Digit5 | 5 | 53 | 0 (Standard) |
| 6 | Digit6 | 6 | 54 | 0 (Standard) |
| 7 | Digit7 | 7 | 55 | 0 (Standard) |
| 8 | Digit8 | 8 | 56 | 0 (Standard) |
| 9 | Digit9 | 9 | 57 | 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 numérique
Vous n’utilisez que le clavier ? Appuyez sur Échap, puis sur Tab, pour quitter la zone de touche.
Code pour réagir à 0
document.addEventListener('keydown', (event) => {
if (event.key === '0') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Digit0') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 48) {
// Votre code ici
}
});Quelle valeur utiliser
Pour réagir à un chiffre tapé, vérifiez event.key : /^[0-9]$/.test(event.key). Cela accepte la rangée du haut et le pavé numérique (Verr. num activé), sur toutes les dispositions qui tapent le chiffre.
Utilisez event.code (Digit1) quand la place compte, par exemple « appuyez sur 1 à 5 » pour choisir un emplacement dans un jeu. Le code est le même sur toutes les dispositions, même quand la touche tape autre chose sans Maj.
keyCode 48 à 57 ne concerne que la rangée du haut. Le pavé numérique envoie 96 à 105 pour les mêmes chiffres : une vérification de 48 à 57 ne le voit donc pas.
Ce qui pose problème
Les chiffres n’arrivent pas depuis un clavier français
Sur un clavier français AZERTY sous Windows, la rangée du haut tape & é “ ’ ( - è _ ç à sans Maj. Les chiffres demandent Maj. Appuyer sur Digit2 envoie donc event.key « é », alors que keyCode indique toujours 50 dans Chrome et Firefox sous Windows. Pour un nombre tapé, lisez la valeur du champ ou event.key. Pour les raccourcis du type « appuyez sur 1 », vérifiez event.code, pour que les utilisateurs français n’aient pas à maintenir Maj.
Maj+2 ne donne pas « @ » partout
Les symboles de Maj + chiffre dépendent de la disposition. Maj + 2 donne « @ » sur un clavier américain et " sur les claviers britanniques et allemands. Maj + 3 donne « # » sur un clavier américain, « £ » sur un britannique et « § » sur un allemand. Pour détecter un symbole, vérifiez event.key === '@', pas event.shiftKey avec Digit2. Un vieux code qui transforme keyCode 50 plus Maj en « @ » tape autre chose pour ces utilisateurs.
Le pavé numérique envoie d’autres codes
Un chiffre du pavé numérique a son propre code (Numpad1) et son propre keyCode (97), mais le même event.key « 1 » tant que Verr. num est activé. Avec Verr. num désactivé, il envoie « End ». Beaucoup de portables n’ont pas de pavé numérique : ne l’exigez jamais. Vérifiez event.key et les deux rangées marchent.
Taper un nombre dans un champ déclenche votre raccourci
Les raccourcis à une touche comme 1 à 9 se déclenchent aussi quand l’utilisateur tape dans un champ. Ignorez les touches destinées à un champ de texte :
if (event.target.closest('input, textarea, select, [contenteditable]')) return;