Keycodes der Zifferntasten (0–9)

Die Zifferntasten über den Buchstaben senden event.code „Digit0“ bis „Digit9“, bei einem US-Layout event.key „0“ bis „9“ und keyCode 48 bis 57.

Alle Werte auf einen Blick

Werte für Zifferntasten 0–9
Tasteevent.codeevent.keykeyCodeevent.location
0Digit00480 (Standard)
1Digit11490 (Standard)
2Digit22500 (Standard)
3Digit33510 (Standard)
4Digit44520 (Standard)
5Digit55530 (Standard)
6Digit66540 (Standard)
7Digit77550 (Standard)
8Digit88560 (Standard)
9Digit99570 (Standard)

keyCode so, wie Chrome und Edge ihn unter Windows senden. Die Mac-Spalte (Chrome und Safari am Mac) und die Firefox-Spalte zeigen nur Zahlen, die abweichen. Manche Tasten unterscheiden sich auch je nach System, wie der Text unten sagt. event.which ist immer dieselbe Zahl wie keyCode. event.key gilt für ein US-Layout ohne Umschalt.

Hier drücken

Klicke hier und drücke dann eine Zifferntaste

Du nutzt nur die Tastatur? Drücke Esc und dann Tab, um das Tastenfeld zu verlassen.

Code, der auf 0 reagiert

Empfohlen: event.key prüfen
document.addEventListener('keydown', (event) => {
  if (event.key === '0') {
    // Dein Code hier
  }
});
Platz der Taste prüfen: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Digit0') {
    // Dein Code hier
  }
});
Alter Code, der noch keyCode nutzt (veraltet)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 48) {
    // Dein Code hier
  }
});

Welchen Wert du nutzen solltest

Wenn du auf eine getippte Ziffer reagieren willst, prüfe event.key: /^[0-9]$/.test(event.key). Das erkennt die obere Reihe und den Ziffernblock (bei eingeschaltetem Num-Lock) auf jedem Layout, das die Ziffer schreibt.

Nimm event.code (Digit1), wenn der Platz der Taste wichtig ist. Ein Beispiel ist „Drücke 1 bis 5“, um in einem Spiel einen Slot zu wählen. Der Code ist auf jedem Layout gleich, auch wenn die Taste ohne Umschalt etwas anderes schreibt.

keyCode 48 bis 57 gilt nur für die obere Reihe. Der Ziffernblock sendet für dieselben Ziffern 96 bis 105. Eine Prüfung auf 48 bis 57 übersieht ihn deshalb.

Wo es oft hakt

Ziffern kommen von einer französischen Tastatur nicht an

Auf einer französischen AZERTY-Tastatur unter Windows schreibt die obere Reihe ohne Umschalt & é “ ’ ( - è _ ç à. Für Ziffern brauchst du Umschalt. Drückst du Digit2, sendet das event.key „é“. keyCode bleibt in Chrome und Firefox unter Windows trotzdem 50. Für eine getippte Zahl liest du den Wert des Feldes oder event.key. Für Kürzel wie „Drücke 1“ prüfst du event.code. So müssen Leute mit französischer Tastatur Umschalt nicht halten.

Umschalt+2 ist nicht überall „@“

Die Zeichen auf Umschalt + Ziffer hängen vom Layout ab. Umschalt + 2 ist auf einer US-Tastatur „@“, auf britischen und deutschen Tastaturen ". Umschalt + 3 ist „#“ auf einer US-Tastatur, „£“ auf einer britischen und „§“ auf einer deutschen. Willst du ein Zeichen abfangen, prüfe event.key === '@'. Prüfe nicht event.shiftKey zusammen mit Digit2. Alter Code, der keyCode 50 plus Umschalt in „@“ verwandelt, schreibt für diese Leute das Falsche.

Der Ziffernblock sendet andere Codes

Eine Ziffer auf dem Ziffernblock hat einen eigenen Code (Numpad1) und keyCode (97). Bei eingeschaltetem Num-Lock ist event.key aber gleich: „1“. Bei ausgeschaltetem Num-Lock sendet die Taste stattdessen „End“. Viele Laptops haben gar keinen Ziffernblock. Verlange ihn also nie: Prüfe event.key, dann funktionieren die Ziffernreihe und der Ziffernblock.

Beim Tippen einer Zahl in ein Feld löst dein Kürzel aus

Einzeltasten-Kürzel wie 1 bis 9 lösen auch aus, wenn jemand in ein Feld tippt. Überspringe Tasten, die für ein Textfeld gedacht sind:

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