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.
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
document.addEventListener('keydown', (event) => {
if (event.key === '0') {
// Seu código aqui
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Digit0') {
// Seu código aqui
}
});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;