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
| Touche | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Entrée / Retour | Enter | Enter | 13 | 0 (Standard) |
| Pavé num. Entrée | NumpadEnter | Enter | 13 | 3 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Enter') {
// Votre code ici
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Enter') {
// Votre code ici
}
});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().