La propriétéonkeydown, rattachée au mixinGlobalEventHandlers, estun gestionnaire d'évènements qui permet de traiter les évènementskeydown.

L'évènementkeydown est déclenché lorsque l'utilisatrice ou l'utilisateur appuie sur une touche du clavier.

Syntaxe

cible.onkeydown = refFunction;

Value

refFunction est un nom de fonction ou uneexpression de fonction. La fonction reçoit un objetKeyboardEvent comme unique argument.

Exemple

Cet exemple affiche la valeur deKeyboardEvent.code à chaque fois qu'on appuie sur une touche à l'intérieur de l'élément<input>.

HTML

<input /><p></p>

JavaScript

const input = document.querySelector("input");const log = document.getElementById("log");input.onkeydown = logKey;function logKey(e) {  log.textContent += ` ${e.code}`;}

Résultat

Spécifications

Compatibilité des navigateurs

Notes de compatibilité

Depuis Firefox 65, les évènementskeyup etkeydown sont désormais déclenchés pendant la composition IME afin d'améliorer la compatibilité entre les navigateurs pour les locuteurs de langues asiatiques (CJKT) (voirle bug 354358). Pour ignorer les évènementskeydown qui font partie d'une composition, on pourra écrire quelque chose d'analogue au fragment qui suit (229 est une valeur spéciale dekeyCode relative à un évènement qui a été traité par un IME) :

eventTarget.addEventListener("keydown", (event) => {  if (event.isComposing || event.keyCode === 229) {    return;  }  // faire quelque chose});

Voir aussi

• L'évènementkeydown
• Les gestionnaires d'évènements associés
  • GlobalEventHandlers.onkeypress
  • GlobalEventHandlers.onkeyup