GlobalEventHandlers.onkeydown

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La propriété onkeydown, rattachée au mixin GlobalEventHandlers, est un gestionnaire d'évènements qui permet de traiter les évènements keydown.

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

Syntaxe

js
cible.onkeydown = refFunction;

Value

refFunction est un nom de fonction ou une expression de fonction. La fonction reçoit un objet KeyboardEvent comme unique argument.

Exemple

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

HTML

html
<input />
<p id="log"></p>

JavaScript

js
const input = document.querySelector("input");
const log = document.getElementById("log");

input.onkeydown = logKey;

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

Résultat

Spécifications

Specification
UI Events
# event-type-keydown
HTML
# handler-onkeydown

Compatibilité des navigateurs

Notes de compatibilité

Depuis Firefox 65, les évènements keyup et keydown 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) (voir le bug 354358). Pour ignorer les évènements keydown qui font partie d'une composition, on pourra écrire quelque chose d'analogue au fragment qui suit (229 est une valeur spéciale de keyCode relative à un évènement qui a été traité par un IME) :

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

Voir aussi