CKTIS / JavaScript
Champs de KeyboardEvent : signification, position et état des touches
Distinguez la valeur d’une touche de sa position physique, et examinez la répétition, l’état de Shift et la composition de texte. Ces champs de KeyboardEvent aident à gérer les raccourcis sans confondre la disposition du clavier et le texte saisi.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.key; event.code; event.repeat; event.shiftKey; event.isComposingKeyboardEvent décrit des événements clavier tels que keydown et keyup. Les cinq propriétés présentées ici (key, code, repeat, shiftKey et isComposing) sont en lecture seule, mais certaines propriétés héritées de Event, comme cancelBubble, sont accessibles en écriture. KeyboardEvent.key est une chaîne qui indique la signification de la touche en tenant compte de la disposition et des modificateurs, par exemple "z", "Z" ou "Enter". KeyboardEvent.code est une chaîne qui identifie la position physique de la touche, indépendamment de la disposition : sur un clavier QWERTZ, "KeyY" peut accompagner key: "Z". Utilisez key pour la signification de la touche et code pour les commandes fondées sur sa position.
KeyboardEvent.repeat est un booléen : true indique la répétition automatique d’une touche maintenue, et non un nombre de répétitions. Dans un gestionnaire keydown, if (event.repeat) return; peut ignorer les actions répétées. KeyboardEvent.shiftKey indique si Shift était actif au moment de l’événement ; cela ne signifie pas que l’événement concerne Shift lui-même. Lorsqu’on enfonce une touche Shift (keydown), la valeur est true ; lorsqu’on la relâche (keyup), elle peut rester à true si l’autre touche Shift est toujours enfoncée.
KeyboardEvent.isComposing est un booléen qui indique qu’un événement se produit entre compositionstart et compositionend, par exemple pendant la composition de texte par une IME. Ignorer les raccourcis lorsque sa valeur est true réduit les interférences avec la composition, mais ne détecte pas tous les cas limites des IME : sa valeur peut être false au début ou à la fin de la composition. Les événements clavier ne remplacent pas l’événement input pour suivre les changements de texte.
Il s’agit d’API Web du navigateur, et non de fonctionnalités propres à une édition d’ECMAScript ; Node 24 dans le dépôt ne permet pas d’établir leur disponibilité. Vérifiez la compatibilité de chaque propriété avec les navigateurs visés ; MDN indique repeat comme Baseline 2025, ce qui ne garantit pas sa prise en charge dans les versions plus anciennes. L’exemple construit un événement synthétique avec des valeurs explicites : il vérifie l’accès aux champs, pas les véritables pressions de touches ni le comportement d’une IME.
Exemples
(() => {
const event = new KeyboardEvent("keydown", {
key: "Z",
code: "KeyY",
repeat: true,
shiftKey: true,
isComposing: false
});
const { key, code, repeat, shiftKey, isComposing } = event;
console.log(JSON.stringify({ key, code, repeat, shiftKey, isComposing }));
})();Résultat
{"key":"Z","code":"KeyY","repeat":true,"shiftKey":true,"isComposing":false}Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.