Códigos das teclas de letras (A–Z)

As teclas de letras enviam event.code "KeyA" a "KeyZ", event.key "a" a "z" em um layout US ("A" a "Z" com Shift ou Caps Lock) e keyCode 65 a 90.

Todos os valores de relance

Valores de Letras A–Z
Teclaevent.codeevent.keykeyCodeevent.location
AKeyAa650 (Padrão)
BKeyBb660 (Padrão)
CKeyCc670 (Padrão)
DKeyDd680 (Padrão)
EKeyEe690 (Padrão)
FKeyFf700 (Padrão)
GKeyGg710 (Padrão)
HKeyHh720 (Padrão)
IKeyIi730 (Padrão)
JKeyJj740 (Padrão)
KKeyKk750 (Padrão)
LKeyLl760 (Padrão)
MKeyMm770 (Padrão)
NKeyNn780 (Padrão)
OKeyOo790 (Padrão)
PKeyPp800 (Padrão)
QKeyQq810 (Padrão)
RKeyRr820 (Padrão)
SKeySs830 (Padrão)
TKeyTt840 (Padrão)
UKeyUu850 (Padrão)
VKeyVv860 (Padrão)
WKeyWw870 (Padrão)
XKeyXx880 (Padrão)
YKeyYy890 (Padrão)
ZKeyZz900 (Padrão)

keyCode como o Chrome e o Edge enviam no Windows. A coluna do Mac (Chrome e Safari no Mac) e a do Firefox mostram só os números diferentes; algumas teclas também mudam conforme o sistema, como diz o texto abaixo. event.which é sempre o mesmo número do keyCode. event.key vale para um layout dos EUA sem Shift.

Pressione aqui

Clique aqui e pressione uma tecla de letra

Está usando só o teclado? Pressione Esc e depois Tab para sair da caixa de teclas.

Código para reagir a A

Recomendado: identificar por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'a') {
    // Seu código aqui
  }
});
Identificar pelo lugar da tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'KeyA') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 65) {
    // Seu código aqui
  }
});

Qual valor usar

Depende do que importa: a letra ou o lugar da tecla no teclado.

Para letras digitadas e atalhos com nome de letra, como Ctrl + Z para desfazer, verifique event.key. Ele segue o layout do usuário, então o atalho funciona na tecla que mostra um Z.

Para teclas escolhidas pelo lugar, como WASD em um jogo, verifique event.code. KeyW é a tecla acima do S em qualquer layout, até em um teclado francês AZERTY, onde ela digita “z”.

keyCode é o número da letra maiúscula: 65 para A até 90 para Z, com ou sem Shift. Em layouts latinos, ele costuma seguir a letra digitada. No AZERTY, a tecla com código KeyQ digita “a” e envia 65. Em layouts russo, grego e outros não latinos, costuma ser a letra US daquele lugar.

O que costuma dar errado

event.key é “A” em vez de “a”

Shift e Caps Lock mudam o event.key. Compare em minúsculas, event.key.toLowerCase() === 'a', e verifique event.shiftKey à parte se o Shift importar. Isso também ajuda no Mac, onde Cmd + Shift + Z pode chegar como um “z” minúsculo.

Os controles WASD não funcionam em um teclado francês

Se você verifica event.key === 'w', jogadores de AZERTY precisam alcançar o W no canto inferior esquerdo. Verifique event.code (KeyW, KeyA, KeyS, KeyD) para as teclas ficarem no mesmo lugar. Para mostrar as letras certas no texto de ajuda, o Chrome e o Edge informam o que um código digita: navigator.keyboard.getLayoutMap().

Ctrl+Z cai na tecla errada em teclados alemães ou franceses

O QWERTZ alemão troca Z e Y, e no AZERTY o Z fica onde está o W em um teclado US. Um atalho verificado com event.code === 'KeyZ' faz usuários alemães apertarem a tecla marcada com Y. Compare atalhos de letra com event.key.

Atalhos param de funcionar em um layout russo ou grego

Nesses layouts, event.key é a letra daquele alfabeto: Ctrl + Z em um layout russo envia “я”. Use o lugar da tecla quando ela não for uma letra latina:

const letter = /^[a-z]$/i.test(event.key)
  ? event.key.toLowerCase()
  : event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';

Alt+letra digita um caractere no Mac

Option + S digita “ß”, então event.key é “ß”, e não “s”. Option + E é uma tecla morta: event.key é “Dead” e a próxima letra recebe o acento. Compare atalhos com Alt usando event.code e event.altKey. No Windows, layouts com AltGr fazem o mesmo com Ctrl + Alt: Ctrl + Alt + E digita € em um teclado alemão. Por isso, evite atalhos com Ctrl + Alt + letra.