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
Exemple
#<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>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
#<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
truelorsque 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
#<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>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
#- onclickExécute du code JavaScript au clic sur l’élément. La façon la plus simple, mais pas la meilleure, de gérer les événements.
- oninputExécute du code JavaScript à chaque modification de la valeur d’un champ : après la saisie d’un caractère, un collage de texte ou le déplacement d’un curseur.
- accesskeyUn raccourci clavier qui place le focus sur l’élément ou l’active immédiatement.
- tabindexDétermine si un élément peut recevoir le focus avec la touche Tab et dans quel ordre.
- <kbd>Une saisie effectuée par l’utilisateur : des touches, des raccourcis clavier et des commandes à saisir.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.