KeyboardEvent.key

La propriété en lecture seule KeyboardEvent.key retourne la valeur d’une ou plusieurs touches pressées par l’utilisateur. Ce peut être l’une des valeurs suivantes:

• Si la valeur a une représentation d’impression, ce sera une chaîne de caractères Unicode non vide.
• Si la valeur est une touche de contrôle, une des valeurs de touches pré-définies.
• Si l’évènement est causé par l’appui sur une touche morte, la valeur de la touche sera "Dead".
• Si plus d’une touche est pressée et que la combinaison inclue un modifieur qui peut rendre la combinaison non imprimable, ce sera le caractère imprimable qui sera rendu. Par exemple, si la combinaison était 'Control' + 'a', la lettre 'a' serait retournée.
• Si la valeur ne peut être identifiée, 'Unidentified' sera retourné.

Exemple

window.addEventListener("keydown", function (event) {
  if (event.defaultPrevented) {
    return; // Should do nothing if the key event was already consumed.
  }

  switch (event.key) {
    case "ArrowDown":
      // Do something for "down arrow" key press.
      break;
    case "ArrowUp":
      // Do something for "up arrow" key press.
      break;
    case "ArrowLeft":
      // Do something for "left arrow" key press.
      break;
    case "ArrowRight":
      // Do something for "right arrow" key press.
      break;
    case "Enter":
      // Do something for "enter" or "return" key press.
      break;
    case "Escape":
      // Do something for "esc" key press.
      break;
    default:
      return; // Quit when this doesn't handle the key event.
  }

  // Consume the event for suppressing "double action".
  event.preventDefault();
}, true);

Spécification

Compatibilité des navigateursrowser compatibility

[1]: Internet Explorer's implementation does not completely match the current spec because it is based on an older version of the spec.

[2]: WebKit bug #69029

Valeurs des touches

Le tableau suivante montre quelles valeurs sont utilisées pour chaque code de touche virtuel.

Key values on Windows (and char values of IE)

Key values of WM_APPCOMMAND message on Windows

On Windows, some keys on multimedia keyboard don't cause WM_KEYDOWN nor WM_KEYUP message. Instead, WM_APPCOMMAND is fired. If WM_APPCOMMAND is caused by a key press, Gecko dispatches DOM keyboard events starting from 37 (bug 865561).

Key values on Mac

Key values on Android and Firefox OS

Key values on Linux (GTK/XKB)

Key values on Qt toolkit