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

Valeurs pour Touches numériques 0 à 9
Toucheevent.codeevent.keykeyCodeevent.location
0Digit00480 (Standard)
1Digit11490 (Standard)
2Digit22500 (Standard)
3Digit33510 (Standard)
4Digit44520 (Standard)
5Digit55530 (Standard)
6Digit66540 (Standard)
7Digit77550 (Standard)
8Digit88560 (Standard)
9Digit99570 (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

Recommandé : reconnaître event.key
document.addEventListener('keydown', (event) => {
  if (event.key === '0') {
    // Votre code ici
  }
});
Reconnaître la place de la touche : event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Digit0') {
    // Votre code ici
  }
});
Ancien code qui utilise encore keyCode (obsolète)
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;