Códigos das teclas numéricas (0–9)

As teclas numéricas acima das letras enviam event.code "Digit0" a "Digit9", event.key "0" a "9" em um layout US e keyCode 48 a 57.

Todos os valores de relance

Valores de Teclas numéricas 0–9
Teclaevent.codeevent.keykeyCodeevent.location
0Digit00480 (Padrão)
1Digit11490 (Padrão)
2Digit22500 (Padrão)
3Digit33510 (Padrão)
4Digit44520 (Padrão)
5Digit55530 (Padrão)
6Digit66540 (Padrão)
7Digit77550 (Padrão)
8Digit88560 (Padrão)
9Digit99570 (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 numérica

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

Código para reagir a 0

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 === 'Digit0') {
    // Seu código aqui
  }
});
Código antigo que ainda usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 48) {
    // Seu código aqui
  }
});

Qual valor usar

Para reagir a um dígito digitado, verifique event.key: /^[0-9]$/.test(event.key). Isso aceita a fileira de cima e o teclado numérico (com Num Lock ligado), em qualquer layout que digite o dígito.

Use event.code (Digit1) quando o lugar importar, como em “aperte de 1 a 5” para escolher um espaço em um jogo. O código é o mesmo em todos os layouts, mesmo onde a tecla digita outra coisa sem Shift.

keyCode 48 a 57 vale só para a fileira de cima. O teclado numérico envia 96 a 105 para os mesmos dígitos, então uma verificação de 48 a 57 não pega essas teclas.

O que costuma dar errado

Os dígitos não chegam de um teclado francês

Em um teclado francês AZERTY no Windows, a fileira de cima digita & é “ ’ ( - è _ ç à sem Shift. Os dígitos precisam do Shift. Assim, apertar Digit2 envia event.key “é”, enquanto o keyCode ainda diz 50 no Chrome e no Firefox do Windows. Para um número digitado, leia o valor do campo ou event.key. Para atalhos de “aperte 1”, verifique event.code, para usuários franceses não precisarem segurar o Shift.

Shift+2 não é “@” em todo lugar

Os símbolos de Shift + dígito dependem do layout. Shift + 2 é “@” em um teclado US e " em teclados britânicos e alemães. Shift + 3 é “#” em um teclado US, “£” em um britânico e “§” em um alemão. Para pegar um símbolo, verifique event.key === '@', e não event.shiftKey com Digit2. Código antigo que transforma keyCode 50 mais Shift em “@” digita o símbolo errado para esses usuários.

O teclado numérico envia outros códigos

Um dígito do teclado numérico tem código próprio (Numpad1) e keyCode próprio (97), mas o mesmo event.key “1” com Num Lock ligado. Com Num Lock desligado, ele envia “End”. Muitos notebooks não têm teclado numérico, então nunca exija um: verifique event.key e as duas fileiras funcionam.

Digitar um número em um campo dispara o seu atalho

Atalhos de uma tecla só, como 1 a 9, também disparam quando o usuário digita em um campo. Ignore teclas dirigidas a um campo de texto:

if (event.target.closest('input, textarea, select, [contenteditable]')) return;