Code de la touche Entrée

Entrée envoie event.key « Enter » et keyCode 13. Les deux touches Entrée les partagent ; event.code et event.location les distinguent.

Toutes les valeurs d’un coup d’œil

Valeurs pour Entrée
Toucheevent.codeevent.keykeyCodeevent.location
Entrée / RetourEnterEnter130 (Standard)
Pavé num. EntréeNumpadEnterEnter133 (Pavé numérique)

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 Entrée

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

Code pour réagir à Entrée

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

Quelle valeur utiliser

Vérifiez event.key === 'Enter'. C’est identique pour la touche Entrée principale et celle du pavé numérique, sur toutes les dispositions, et aussi sur les claviers de téléphone qui envoient une vraie Entrée.

N’utilisez event.code que si les deux touches doivent faire des choses différentes : Enter est la grande touche, NumpadEnter celle du pavé numérique. La touche retour du Mac est la même touche : elle envoie aussi Enter.

keyCode 13 arrive encore dans tous les navigateurs, donc l’ancien code continue de marcher, mais il est obsolète.

Ce qui pose problème

Entrée envoie le message pendant que quelqu’un écrit encore en japonais, chinois ou coréen

Avec une méthode de saisie, Entrée confirme d’abord le caractère en cours de construction. Votre gestionnaire keydown voit aussi cette Entrée. Ignorez-la tant qu’un caractère est en cours de composition :

if (event.isComposing || event.keyCode === 229) return;

Vérifiez les deux : Safari envoie l’Entrée de confirmation avec isComposing faux mais keyCode 229.

Appuyer sur Entrée dans un champ de texte envoie le formulaire

C’est la soumission implicite du navigateur. Appelez event.preventDefault() dans le gestionnaire keydown si Entrée doit faire autre chose, ou écoutez l’événement submit du formulaire plutôt que la touche, ce qui attrape aussi le bouton OK des claviers de téléphone.

Le gestionnaire s’exécute deux fois ou plusieurs fois

Maintenir Entrée répète le keydown. Ignorez les répétitions avec if (event.repeat) return; quand Entrée lance quelque chose qui ne doit arriver qu’une fois, comme l’envoi d’un message.

keypress ou keyup ne se comportent pas comme keydown

keypress est obsolète et ne se déclenche que pour les touches qui écrivent quelque chose ; il se déclenche encore pour Entrée, mais ne comptez pas dessus. keyup arrive après que le navigateur a déjà envoyé le formulaire ou ajouté le retour à la ligne : trop tard pour l’arrêter. Utilisez keydown.

Entrée sur un téléphone affiche « OK », « Suivant » ou « Envoyer »

C’est vous qui choisissez le libellé : ajoutez enterkeyhint="send" (ou go, next, search, done) au champ. Les claviers Android envoient la plupart des touches avec keyCode 229, mais Entrée arrive en général comme une vraie Enter avec keyCode 13.

Maj+Entrée et Ctrl+Entrée

Les zones de discussion envoient en général sur Entrée et ajoutent un retour à la ligne sur Maj + Entrée : vérifiez event.shiftKey. Ctrl + Entrée (Commande + Entrée sur un Mac) est le raccourci courant pour « envoyer quand même » : vérifiez event.ctrlKey || event.metaKey. Dans un <textarea>, Entrée ajoute un retour à la ligne sauf si vous appelez preventDefault().