Atributo key do KeyboardEvent

Evento DOM KeyboardEvent

Definição e Uso

A propriedade key retorna o identificador da tecla pressionada no momento do evento de tecla.

O identificador de tecla é uma string que identifica o botão de teclado. O valor retornado por esta propriedade pode ser uma das seguintes strings:

  • Caracteres únicos (por exemplo, "a", "W", "4", "+" ou "$")
  • Caracteres múltiplos (por exemplo, "F1", "Enter", "HOME" ou "CAPS LOCK")

Notas：Este atributo é apenas de leitura.

Dica：Se você quiser saber se o "ALT", "CTRL", "META" ou "SHIFT" foi pressionado no momento do evento de tecla, use altKey、ctrlKey、metaKey ou shiftKey Atributo

Exemplo

Exemplo 1

Obtenha o botão de teclado pressionado no momento do evento de tecla:

var x = event.key;

Experimente por Si Mesmo

Exemplo 2

Se o usuário pressionar a tecla "A", mostre algum texto：

var x = event.key;
// Se o botão de teclado pressionado for "a" ou "A" (usando CapsLock ou Shift), mostre algum texto.
if (x == "a" || x == "A") { 
  alert("Você pressionou a tecla 'A'!");
}

Experimente por Si Mesmo

Sintaxe

event.key

Detalhes Técnicos

Retorno：

String que representa o botão de teclado pressionado.

Valores Possíveis：

  • Caracteres únicos (por exemplo, "a", "W", "4", "+" ou "$")
  • Caracteres múltiplos (por exemplo, "F1", "Enter", "HOME" ou "CAPS LOCK")

Notas：Retorna undefined no Safari.
Versão do DOM： DOM Level 3

Suporte do Navegador

Os números na tabela indicam a primeira versão do navegador que suporta plenamente o atributo.

Atributo Chrome IE Firefox Safari Opera
key 51.0 9.0 23.0 Não suportado 38.0

Páginas Relacionadas

Manual de Referência do HTML DOM：Propriedade keyCode do KeyboardEvent

Manual de Referência do HTML DOM：Propriedade which do KeyboardEvent

Manual de Referência do HTML DOM：Propriedade charCode do KeyboardEvent

Evento DOM KeyboardEvent