CKTIS / JavaScript
KeyboardEvent : valeur de la touche et état de Maj
`key` donne la valeur de la touche et `shiftKey` indique si Maj était active au moment de l’événement. Utilisez les deux pour distinguer Entrée de Maj+Entrée.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
event.key // string, read-only
event.shiftKey // boolean, read-onlykey et shiftKey sont deux propriétés en lecture seule d’une instance de KeyboardEvent. event.key est une chaîne : elle donne la représentation textuelle d’une touche imprimable ou une valeur prédéfinie comme "Enter" pour une touche spéciale. Pour les événements générés par le navigateur, la disposition du clavier et les modificateurs actifs influencent key. Si c’est la position physique de la touche qui compte, utilisez plutôt event.code.
event.shiftKey est un booléen : true si Maj était active au moment de l’événement, false sinon. Cette valeur décrit cet événement, pas l’état actuel du clavier. Ne confondez pas event.key === "Shift", qui identifie la touche Maj elle-même, avec event.shiftKey, qui peut valoir true pour une autre touche.
Dans un gestionnaire de keydown, event.key === "Enter" && event.shiftKey détecte Entrée avec Maj active. Cette condition n’exclut pas les autres modificateurs. KeyboardEvent est une API du Web, pas une fonctionnalité d’ECMAScript 2024 ; sa disponibilité dépend de l’environnement d’exécution.
Exemples
{
const eventInits = [
{ key: "Enter" },
{ key: "Enter", shiftKey: true },
];
// Without KeyboardEvent, use plain objects to model just these two properties.
const events = eventInits.map((init) =>
typeof KeyboardEvent === "function"
? new KeyboardEvent("keydown", init)
: { key: init.key, shiftKey: init.shiftKey ?? false }
);
for (const event of events) {
const isShiftEnter = event.key === "Enter" && event.shiftKey;
console.log(`${event.key} | shiftKey=${event.shiftKey} | match=${isShiftEnter}`);
}
}Résultat
Enter | shiftKey=false | match=false Enter | shiftKey=true | match=true
Exécutez le code dans la console de développement d’un navigateur ou comme script dans Node.js. Dans le navigateur, il crée deux instances synthétiques de `KeyboardEvent` sans les distribuer. Si le constructeur est indisponible, il utilise de simples objets qui reproduisent uniquement les propriétés `key` et `shiftKey`. Dans les deux objets, `key` vaut `"Enter"`. Dans le premier, `shiftKey` est omise dans les options et vaut donc `false` ; dans le second, elle est définie à `true`. Seul le second objet remplit la condition.
Leçons associées
- JavaScript · Leçon 40 · Intermédiaire · Version : 3