keypress

O evento keypress é disparado quando uma tecla que produz um valor do tipo caractere é pressionada. Exemplos de chaves que produzem um valor de caractere são chaves alfabéticas, numéricas e de pontuação. Exemplos de chaves que não produzem um valor de caractere são as teclas modificadoras, como Alt, Shift, Ctrl, ou Meta.

Informações gerais

Especificação

DOM L3

Interface

KeyboardEvent

Bolhas

sim

Cancelável

sim

Alvo

Documento, Elemento

Ação padrão

Varia: keypressevento; lançar sistema de composição de texto; blure focuseventos; DOMActivateevento; outro evento

Propriedades

Propriedade Tipo Descrição
target Somente leitura EventTarget O destino do evento (o destino mais alto na árvore do DOM).
type Somente leitura DOMString O tipo de evento.
bubbles Somente leitura boleano Se o evento normalmente borbulha ou não
cancelable Somente leitura boleano Se o evento é cancelável ou não
view Somente leitura WindowProxy document.defaultView( windowdo documento)
detail Somente leitura long( float) 0
target Somente leitura EventTarget (elemento DOM) Elemento focalizado processando o evento chave, elemento raiz se nenhum elemento de entrada adequado estiver focalizado.
char Somente leitura DOMString (string) O valor do caractere da chave. Se a chave corresponder a um caractere imprimível, esse valor será uma string Unicode não vazia contendo esse caractere. Se a chave não tiver uma representação imprimível, esta é uma string vazia. Veja nomes de chaves e valores de caracteres para os detalhes.
Nota: Se a chave for usada como uma macro que insere vários caracteres, o valor desse atributo é a cadeia inteira, não apenas o primeiro caractere.
key Somente leitura DOMString (string)

O valor-chave da chave representada pelo evento. Se o valor tiver uma representação impressa, o valor desse atributo será o mesmo da charpropriedade. Caso contrário, é uma das cadeias de valores de chave especificadas nos valores de chave . Se a chave não puder ser identificada, seu valor será a string "Unidentified". Veja os nomes das chaves e os valores de caracteres para mais detalhes. Somente leitura.

code Somente leitura DOMString (string) Contém uma string que identifica a tecla física sendo pressionada. O valor não é afetado pelo layout do teclado atual ou pelo estado do modificador, portanto, uma chave específica sempre retornará o mesmo valor.
charCode Somente leitura Longo não assinado (int) O número de referência Unicode da chave; esse atributo é usado apenas pelo keypressevento. Para chaves cujo charatributo contém vários caracteres, esse é o valor Unicode do primeiro caractere nesse atributo.
Aviso: este atributo está obsoleto; você deve usar em charvez disso, se disponível.
keyCode Somente leitura Longo não assinado (int) Um código numérico dependente do sistema e da implementação que identifica o valor não modificado da tecla pressionada. Este é geralmente o código ASCII decimal (RFC 20) ou Windows 1252 correspondente à chave; veja Códigos de teclas virtuais para uma lista de valores comuns. Se a chave não puder ser identificada, esse valor será 0.
Aviso: este atributo está obsoleto; você deve usar em keyvez disso, se disponível.
which Somente leitura Longo não assinado (int) Um código numérico dependente do sistema e da implementação identificando o valor não modificado da tecla pressionada; isso geralmente é o mesmo que keyCode.
Aviso: este atributo está obsoleto; você deve usar em keyvez disso, se disponível.
location Somente leitura longo (flutuar) A localização da chave no dispositivo.
repeat Somente leitura boleano truese uma tecla foi pressionada o tempo suficiente para disparar a repetição da tecla, caso contrário false.
locale Somente leitura corda O código do idioma para o evento principal, se disponível; caso contrário, a cadeia vazia.
ctrlKey Somente leitura boleano truese a chave de controle estava inativa quando o evento foi disparado. falsede outra forma.
shiftKey Somente leitura boleano truese a tecla shift estava inativa quando o evento foi disparado. falsede outra forma.
altKey Somente leitura boleano truese a tecla ALT estava desativada quando o evento foi disparado. falsede outra forma.
metaKey Somente leitura boleano truese a meta key estava desativada quando o evento foi disparado. falsede outra forma.

Exemplo

js
document.addEventListener ('keypress', (event) => {
  const keyName = event.key;
  alert ('keypress event \ n \ n' + 'chave:' + nome da chave);
});

Compatibilidade com navegadores

O Chrome não dispara o keypressevento para atalhos de teclado conhecidos ( referência ). Quais atalhos de teclado são conhecidos depende do sistema do usuário. Use o keydownevento para implementar atalhos de teclado.

Eventos Relacionados