Códigos de las teclas de números (0–9)

Las teclas de números sobre las letras envían event.code "Digit0" a "Digit9", event.key "0" a "9" en un teclado inglés (US) y keyCode 48 a 57.

Todos los valores de un vistazo

Valores de Teclas de números 0–9
Teclaevent.codeevent.keykeyCodeevent.location
0Digit00480 (Normal)
1Digit11490 (Normal)
2Digit22500 (Normal)
3Digit33510 (Normal)
4Digit44520 (Normal)
5Digit55530 (Normal)
6Digit66540 (Normal)
7Digit77550 (Normal)
8Digit88560 (Normal)
9Digit99570 (Normal)

keyCode tal como lo envían Chrome y Edge en Windows. La columna de Mac (Chrome y Safari en un Mac) y la de Firefox solo muestran los números que cambian; algunas teclas también cambian según el sistema, como explica el texto de abajo. event.which es siempre el mismo número que keyCode. event.key corresponde a un teclado inglés (US) sin pulsar Mayús.

Púlsala aquí

Haz clic aquí y pulsa una tecla de número

¿Usas solo el teclado? Pulsa Esc y luego Tab para salir del cuadro de teclas.

Código para reaccionar a 0

Recomendado: reconocer por event.key
document.addEventListener('keydown', (event) => {
  if (event.key === '0') {
    // Tu código aquí
  }
});
Reconocer el lugar de la tecla: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Digit0') {
    // Tu código aquí
  }
});
Código antiguo que aún usa keyCode (obsoleto)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 48) {
    // Tu código aquí
  }
});

Qué valor usar

Para reaccionar a un dígito escrito, comprueba event.key: /^[0-9]$/.test(event.key). Acepta la fila superior y el teclado numérico (con Bloq Num activado), en cualquier distribución que escriba el dígito.

Usa event.code (Digit1) cuando importe el lugar, como en “pulsa de 1 a 5” para elegir una ranura en un juego. El código es el mismo en todas las distribuciones, incluso donde la tecla escribe otra cosa sin Shift.

keyCode 48 a 57 es solo la fila superior. El teclado numérico envía 96 a 105 para los mismos dígitos, así que una comprobación de 48 a 57 no lo detecta.

Qué suele salir mal

Los dígitos no llegan desde un teclado francés

En un teclado francés AZERTY en Windows, la fila superior escribe & é “ ’ ( - è _ ç à sin Shift. Los dígitos necesitan Shift. Así, al pulsar Digit2 se envía event.key “é”, mientras que keyCode sigue diciendo 50 en Chrome y Firefox en Windows. Para un número escrito, lee el valor del campo o event.key. Para los atajos de “pulsa 1”, comprueba event.code, así quien usa teclado francés no tiene que mantener Shift.

Shift+2 no es “@” en todas partes

Los símbolos de Shift más un dígito dependen de la distribución. Shift + 2 es “@” en un teclado inglés (US) y " en los teclados británico y alemán. Shift + 3 es “#” en un teclado inglés (US), “£” en uno británico y “§” en uno alemán. En un teclado español (ISO), Shift + 2 escribe " y “@” sale con AltGr + 2. Para detectar un símbolo, comprueba event.key === '@', no event.shiftKey con Digit2. El código antiguo que convierte el keyCode 50 más Shift en “@” escribe algo distinto para estas personas.

El teclado numérico envía otros códigos

Un dígito del teclado numérico tiene su propio código (Numpad1) y keyCode (97), pero el mismo event.key “1” mientras Bloq Num está activado. Con Bloq Num desactivado envía “End”. Muchos portátiles no tienen teclado numérico, así que nunca lo exijas: comprueba event.key para admitir tanto la fila superior como el teclado numérico.

Al escribir un número en un campo salta tu atajo

Los atajos de una sola tecla, como del 1 al 9, también saltan mientras se escribe en un campo. Ignora las teclas dirigidas a un campo de texto:

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