Atributo key de KeyboardEvent

Evento DOM KeyboardEvent

Definición y uso

La propiedad key devuelve el identificador de la tecla pulsada en el momento del evento de pulsación de tecla.

El identificador de tecla es una cadena que identifica el botón de teclado. El valor devuelto por esta propiedad puede ser uno de los siguientes strings:

  • Caracteres individuales (por ejemplo, "a", "W", "4", "+" o "$")
  • Caracteres múltiples (por ejemplo, "F1", "Enter", "HOME" o "CAPS LOCK")

Notas:Este atributo es de solo lectura.

Consejo:Si deseas saber si se pulsó la tecla "ALT", "CTRL", "META" o "SHIFT" en el momento del evento de pulsación de tecla, usa altKey、ctrlKey、metaKey o shiftKey Atributo.

Ejemplo

Ejemplo 1

Obtener el botón de teclado pulsado en el momento del evento de pulsación de tecla:

var x = event.key;

Prueba por tu cuenta

Ejemplo 2

Si el usuario pulsa la tecla "A", muestra algún texto:

var x = event.key;
// Si el botón de teclado pulsado es "a" o "A" (usando CapsLock o Shift), muestra algún texto.
if (x == "a" || x == "A") { 
  alert("Has pulsado la tecla 'A'!");
}

Prueba por tu cuenta

Sintaxis

event.key

Detalles técnicos

Valor devuelto:

Cadena que representa el botón de teclado pulsado.

Valores posibles:

  • Caracteres individuales (por ejemplo, "a", "W", "4", "+" o "$")
  • Caracteres múltiples (por ejemplo, "F1", "Enter", "HOME" o "CAPS LOCK")

Notas:Devuelve undefined en Safari.
Versión DOM: DOM Nivel 3

Compatibilidad del navegador

Los números en la tabla indican la versión del navegador que admite completamente el atributo.

Atributo Chrome IE Firefox Safari Opera
key 51.0 9.0 23.0 No soportado 38.0

Páginas relacionadas

Manual de Referencia HTML DOM:Atributo keyCode del evento KeyboardEvent

Manual de Referencia HTML DOM:Atributo which del evento KeyboardEvent

Manual de Referencia HTML DOM:Atributo charCode del evento KeyboardEvent

Evento DOM KeyboardEvent