CKTIS / JavaScript
KeyboardEvent : valeur de la touche et répétition automatique
Utilisez `key` pour connaître la valeur de la touche et `repeat` pour distinguer l’appui initial des répétitions automatiques lorsque la touche reste enfoncée.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
event.key // string, read-only
event.repeat // boolean, read-only
new KeyboardEvent("keydown", { key: "Enter", repeat: true })KeyboardEvent.key est une propriété en lecture seule qui fournit une chaîne comme "Enter", "a" ou "A". Sa valeur dépend de la disposition du clavier et des modificateurs actifs, comme Shift. Contrairement à code, qui indique la position physique de la touche, key peut changer d’un événement à l’autre si l’état d’un modificateur change.
KeyboardEvent.repeat est une propriété booléenne en lecture seule. Pour les événements keydown réels, elle vaut false à l’appui initial et true pour les événements suivants générés par répétition automatique. Elle n’indique pas si une touche est actuellement enfoncée. Toutes les touches ne se répètent pas, et la cadence dépend de l’environnement.
Pour exécuter une action une seule fois par appui sur Entrée, vérifiez event.key === "Enter" && !event.repeat dans le gestionnaire de keydown. Si l’action doit se répéter tant que la touche reste enfoncée, ne filtrez pas les événements selon repeat.
KeyboardEvent est une API de la plateforme web, pas une fonctionnalité d’ECMAScript 2024. Ne supposez pas qu’elle existe dans tous les environnements d’exécution JavaScript ; vérifiez sa prise en charge dans l’environnement cible.
Exemples
{
function handleKeydown(event) {
if (event.key !== "Enter" || event.repeat) return;
console.log("activate");
}
handleKeydown({ key: "Enter", repeat: false });
handleKeydown({ key: "Enter", repeat: true });
handleKeydown({ key: "Escape", repeat: false });
}Résultat
activate
Exécutez le code dans Node.js ou dans la console d’un navigateur. Le gestionnaire reçoit directement trois objets simples dotés des propriétés `key` et `repeat`, et non des événements clavier. Il affiche `activate` uniquement pour le premier objet ; le test porte sur la condition, pas sur la cadence de répétition.
Leçons associées
- JavaScript · Leçon 34 · Intermédiaire · Version : 3
- JavaScript · Leçon 35 · Intermédiaire · Version : 3
- JavaScript · Leçon 38 · Intermédiaire · Version : 3