---
title: "Códigos das teclas numéricas: 0–9 keyCode 48–57, event.key, event.code"
description: "Os números da fileira de cima enviam keyCode 48 a 57, event.code \"Digit0\" a \"Digit9\" e event.key \"0\" a \"9\". O Shift no teclado francês e o teclado numérico."
url: https://devicetests.com/pt-br/keycode/number-keys
language: pt-BR
---

# 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

| Tecla | event.code | event.key | keyCode | event.location |
| - | - | - | - | - |
| 0 | `Digit0` | `0` | 48 | 0 (Padrão) |
| 1 | `Digit1` | `1` | 49 | 0 (Padrão) |
| 2 | `Digit2` | `2` | 50 | 0 (Padrão) |
| 3 | `Digit3` | `3` | 51 | 0 (Padrão) |
| 4 | `Digit4` | `4` | 52 | 0 (Padrão) |
| 5 | `Digit5` | `5` | 53 | 0 (Padrão) |
| 6 | `Digit6` | `6` | 54 | 0 (Padrão) |
| 7 | `Digit7` | `7` | 55 | 0 (Padrão) |
| 8 | `Digit8` | `8` | 56 | 0 (Padrão) |
| 9 | `Digit9` | `9` | 57 | 0 (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.

## 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;
```

## Teclas relacionadas

- [Códigos das teclas do teclado numérico](https://devicetests.com/pt-br/keycode/numpad)
- [Códigos das teclas de letras (A–Z)](https://devicetests.com/pt-br/keycode/letter-keys)
- [Código da tecla Shift](https://devicetests.com/pt-br/keycode/shift)
- [Códigos das teclas de pontuação (186–222)](https://devicetests.com/pt-br/keycode/punctuation)
- [Descobrir o código de uma tecla: pressione qualquer tecla para ver os códigos](https://devicetests.com/pt-br/keycode)
- [Todos os códigos de tecla em uma tabela](https://devicetests.com/pt-br/keycode#key-codes)
