Códigos das teclas do teclado numérico

Os dígitos do teclado numérico enviam event.code "Numpad0" a "Numpad9", event.key "0" a "9" e keyCode 96 a 105. Os operadores enviam 106 a 111 e o Num Lock envia 144.

Todos os valores de relance

Valores de Teclado numérico
Teclaevent.codeevent.keykeyCodekeyCode no Macevent.location
0 (teclado numérico)Numpad00963 (Teclado numérico)
1 (teclado numérico)Numpad11973 (Teclado numérico)
2 (teclado numérico)Numpad22983 (Teclado numérico)
3 (teclado numérico)Numpad33993 (Teclado numérico)
4 (teclado numérico)Numpad441003 (Teclado numérico)
5 (teclado numérico)Numpad551013 (Teclado numérico)
6 (teclado numérico)Numpad661023 (Teclado numérico)
7 (teclado numérico)Numpad771033 (Teclado numérico)
8 (teclado numérico)Numpad881043 (Teclado numérico)
9 (teclado numérico)Numpad991053 (Teclado numérico)
Multiplicação (teclado numérico)NumpadMultiply*1063 (Teclado numérico)
Mais (teclado numérico)NumpadAdd+1073 (Teclado numérico)
Menos (teclado numérico)NumpadSubtract-1093 (Teclado numérico)
Decimal (teclado numérico)NumpadDecimal.1103 (Teclado numérico)
Divisão (teclado numérico)NumpadDivide/1113 (Teclado numérico)
Enter (teclado numérico)NumpadEnterEnter133 (Teclado numérico)
Num Lock / ClearNumLockNumLock144120 (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 do teclado numérico

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

Código para reagir a 0 (teclado numérico)

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

Qual valor usar

Para dígitos e operadores digitados, verifique event.key. Ele é “1”, “+” ou “*”, igual ao das teclas principais, então uma verificação cobre as duas.

Use event.code (Numpad1, NumpadAdd) só quando o teclado numérico precisar fazer algo próprio, como mover em oito direções em um jogo. event.location é 3 nas teclas do teclado numérico, outra forma de separá-las.

keyCode vai de 96 a 105 nos dígitos, depois 106 para *, 107 para +, 109 para -, 110 para a tecla decimal e 111 para /. O Enter do teclado numérico envia 13, como o Enter principal.

O que costuma dar errado

Com Num Lock desligado, Numpad4 envia ArrowLeft

No Windows e no Linux, as teclas de dígitos viram teclas de navegação quando o Num Lock está desligado. Então Numpad4 envia event.key “ArrowLeft” e keyCode 37, mas event.code continua “Numpad4”. Numpad0 envia “Insert”, Numpad5 envia “Clear” (keyCode 12) e a tecla decimal envia “Delete”. Se faltarem dígitos, verifique event.getModifierState('NumLock') e peça ao usuário para ligar o Num Lock.

O Num Lock envia keyCode 12 no Mac

Teclados de Mac têm uma tecla Clear nesse lugar, e o teclado numérico sempre digita dígitos. Ela envia event.code “NumLock”, mas event.key “Clear” e keyCode 12, em vez de 144.

A tecla decimal digita uma vírgula

No ABNT2 brasileiro, em layouts alemães e em muitos outros, NumpadDecimal digita “,”. event.key é “,” enquanto o keyCode costuma continuar 110. Se você lê números, aceite “.” e “,”.

O teclado numérico do Mac tem uma tecla =

Teclados completos da Apple têm uma tecla =: event.code “NumpadEqual”, event.key “=”. Ela não está na tabela acima, porque teclados de PC raramente a têm. O keyCode dela é 187 no Chrome e no Safari do Mac e 61 no Firefox (no Windows, 12). Por isso, compare por key ou por code.

Muitos teclados não têm teclado numérico

Notebooks, teclados compactos e celulares não têm. Nunca exija as teclas do teclado numérico: aceite também os dígitos da fileira de cima, o que uma verificação de event.key já faz. Alguns notebooks escondem um teclado numérico nas teclas de letras, ativado com Num Lock. Enquanto ele está ligado, essas letras enviam códigos do teclado numérico.