Attribut global HTMLAttributs globaux

onkeydown

Exécute du code JavaScript au moment de l’appui sur une touche. Sert aux raccourcis clavier et à la gestion de touches comme Entrée ou Échap.

S’applique à
Éléments pouvant recevoir le focus, et <body>. L’événement remonte dans l’arbre
Sur cette page

Exemple

#
HTML
<label for="keys">Cliquez dans le champ et appuyez sur une touche</label>
<input id="keys" type="text" onkeydown="
  document.getElementById('key').textContent = 'key: ' + event.key + ', code: ' + event.code;
">
<p id="key">Aucune touche pressée pour l’instant.</p>
Aperçu

Comparez une lettre avec et sans Maj, les flèches, Échap et une lettre tapée avec AltGr, par exemple é sur la disposition US International (AltGr+E). event.key change, alors que event.code reste KeyE, la touche physique.

Définition et utilisation

#

L’attribut onkeydown réagit à l’événement keydown, qui se produit au moment de l’appui sur une touche, avant même que le caractère n’apparaisse dans le champ. Lorsqu’une touche est maintenue enfoncée, l’événement se répète, et event.repeat vaut alors true. Le relâchement de la touche est un événement distinct, keyup.

Les événements du clavier arrivent à l’élément qui a le focus : un champ de formulaire, un bouton, un lien ou un élément avec tabindex ou contenteditable. Un simple <div> sans focus ne les recevra pas. L’événement remonte dans l’arbre, donc un attribut sur <body> gère les touches pressées n’importe où dans la page.

event.key indique quelle touche a été pressée : un caractère ("a", "é", "?") ou un nom de touche ("Enter", "Escape", "ArrowUp"). event.code, lui, donne la position physique de la touche indépendamment de la disposition du clavier, par exemple "KeyW" dans un jeu piloté avec les touches WASD. L’ancienne propriété keyCode et l’événement keypress sont obsolètes. Dans des projets plus importants, ajoutez la gestion avec addEventListener("keydown", …).

Syntaxe

#
Syntaxe
<element onkeydown="code JavaScript">…</element>

Disponible dans le code de l’attribut

#
  • event.key

    Un caractère ou un nom de touche, selon la disposition du clavier et Maj : "a", "A", "Enter", "Escape", "ArrowUp".
  • event.code

    La touche physique, indépendamment de la disposition : "KeyA", "Digit1", "Space", "ArrowUp".
  • event.repeat

    true lorsque l’événement se répète parce que la touche est maintenue enfoncée.
  • event.ctrlKey, shiftKey, altKey, metaKey

    Indique si Ctrl, Maj, Alt ou Cmd sur Mac (la touche Windows sur PC) étaient enfoncées avec la touche. Elles permettent de gérer des raccourcis comme Ctrl + S.
  • event.preventDefault()

    Bloque le comportement par défaut de la touche, par exemple la saisie d’un caractère dans un champ ou le défilement de la page avec une flèche.

Plus d’exemples

#
Une liste de tâches pilotée avec les touches Entrée et Échap
HTML
<input id="task" type="text" aria-label="Nouvelle tâche"
  placeholder="Nouvelle tâche, validez avec Entrée"
  onkeydown="
    if (event.key === 'Enter' && this.value.trim() !== '') {
      const item = document.createElement('li');
      item.textContent = this.value;
      document.getElementById('tasks').append(item);
      this.value = '';
    }
    if (event.key === 'Escape') this.value = '';
  ">
<ul id="tasks"></ul>
Aperçu

Entrée ajoute la tâche à la liste, et Échap vide le champ. Le champ ne se trouve pas dans un formulaire, donc Entrée n’envoie rien.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne bloquez pas sans nécessité les touches standard comme Tab, les flèches ou les raccourcis du navigateur. Les personnes qui utilisent le clavier et les lecteurs d’écran en dépendent.
  • Les raccourcis avec une simple lettre, sans Ctrl ni Alt, se déclenchent facilement par accident, et gênent surtout les personnes qui commandent leur ordinateur à la voix. Permettez de les désactiver ou utilisez des combinaisons avec une touche de modification.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.