Attribut key de KeyboardEvent

Événement DOM KeyboardEvent

Définition et utilisation

L'attribut key retourne l'identifiant de la touche appuyée lors de l'événement de frappe de touche.

L'identifiant de touche est une chaîne de caractères qui identifie le bouton de clavier. La valeur retournée par cette propriété peut être l'une des chaînes suivantes :

  • Caractère unique (par exemple "a", "W", "4", "+" ou "$")
  • Caractères multiples (par exemple "F1", "Entrée", "HOME" ou "CAPS LOCK")

Remarque :Cette propriété est lecture seule.

Astuce :Si vous souhaitez savoir si les touches "ALT", "CTRL", "META" ou "SHIFT" ont été appuyées lors de l'événement de frappe de touche, utilisez altKey、ctrlKey、metaKey ou shiftKey Attribut.

Exemple

Exemple 1

Obtenir le bouton de clavier appuyé lors de l'événement de frappe de touche :

var x = event.key;

Essayez-le vous-même

Exemple 2

Si l'utilisateur appuie sur la touche "A", affichez un texte :

var x = event.key;
// Si le bouton de clavier appuyé est "a" ou "A" (en utilisant CapsLock ou Shift), affichez un texte.
if (x == "a" || x == "A") { 
  alert("Vous avez appuyé sur la touche 'A' !");
}

Essayez-le vous-même

Syntaxe

event.key

Détails techniques

Valeur retournée :

Chaîne de caractères représentant le bouton de clavier appuyé.

Valeurs possibles :

  • Caractère unique (par exemple "a", "W", "4", "+" ou "$")
  • Caractères multiples (par exemple "F1", "Entrée", "HOME" ou "CAPS LOCK")

Remarque :Retourne 'undefined' dans Safari.
Version DOM : DOM Niveau 3

Prise en charge du navigateur

Les nombres dans le tableau indiquent la version du navigateur qui prend en charge pleinement cet attribut.

Attribut Chrome IE Firefox Safari Opera
key 51.0 9.0 23.0 Non pris en charge 38.0

Pages associées

Référence HTML DOM :Propriété keyCode de l'événement KeyboardEvent

Référence HTML DOM :Propriété which de l'événement KeyboardEvent

Référence HTML DOM :Propriété charCode de l'événement KeyboardEvent

Événement DOM KeyboardEvent