Kody klawiszy cyfr (0–9)

Klawisze cyfr nad literami wysyłają event.code od "Digit0" do "Digit9", event.key od "0" do "9" na układzie US i keyCode od 48 do 57.

Wszystkie wartości w skrócie

Klawisze cyfr 0–9 – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
0Digit00480 (Zwykły)
1Digit11490 (Zwykły)
2Digit22500 (Zwykły)
3Digit33510 (Zwykły)
4Digit44520 (Zwykły)
5Digit55530 (Zwykły)
6Digit66540 (Zwykły)
7Digit77550 (Zwykły)
8Digit88560 (Zwykły)
9Digit99570 (Zwykły)

keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.

Naciśnij go tutaj

Kliknij tutaj, a potem naciśnij klawisz cyfry

Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.

Kod, który reaguje na klawisz: 0

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === '0') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'Digit0') {
    // Twój kod tutaj
  }
});
Stary kod, który nadal używa keyCode (jego używanie nie jest już zalecane)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 48) {
    // Twój kod tutaj
  }
});

Której wartości użyć

Żeby zareagować na wpisaną cyfrę, sprawdź event.key: /^[0-9]$/.test(event.key). Warunek zadziała dla cyfr wpisanych z górnego rzędu i z klawiatury numerycznej przy włączonym Num Lock. Działa w każdym układzie, w którym dany klawisz wpisuje cyfrę od 0 do 9.

Użyj event.code (Digit1), gdy ważne jest miejsce klawisza, na przykład „naciśnij klawisz od 1 do 5”, żeby wybrać slot w grze. Kod jest taki sam na każdym układzie, nawet tam, gdzie klawisz bez Shifta wpisuje coś innego.

keyCode od 48 do 57 dotyczy tylko górnego rzędu. Klawiatura numeryczna wysyła dla tych samych cyfr od 96 do 105, więc sprawdzanie od 48 do 57 ją pomija.

Co sprawia kłopoty

Na francuskiej klawiaturze cyfry wymagają klawisza Shift

Na francuskiej klawiaturze AZERTY w Windows górny rząd bez Shifta wpisuje & é “ ’ ( - è _ ç à. Cyfry wymagają Shifta. Po naciśnięciu klawisza o kodzie Digit2 wartość event.key to „é”, a w Chrome i Firefoksie pod Windows wartość keyCode wciąż wynosi 50. Dla wpisanej liczby odczytaj wartość pola albo event.key. Dla skrótów typu „naciśnij 1” sprawdzaj event.code, żeby francuscy użytkownicy nie musieli trzymać Shifta.

Shift+2 nie wszędzie daje „@”

Symbole pod Shift + cyfra zależą od układu. Shift + 2 daje „@” na klawiaturze US i " na brytyjskiej i niemieckiej. Shift + 3 daje „#” na klawiaturze US, „£” na brytyjskiej i „§” na niemieckiej. Żeby wychwycić symbol, sprawdź event.key === '@', a nie event.shiftKey z Digit2. Stary kod, który zamienia keyCode 50 plus Shift na „@”, wpisuje u tych osób zły znak.

Klawiatura numeryczna wysyła inne kody

Cyfra z klawiatury numerycznej ma własny kod (Numpad1) i keyCode (97), ale ten sam event.key „1”, gdy Num Lock jest włączony. Przy wyłączonym Num Lock wysyła zamiast tego „End”. Wiele laptopów w ogóle nie ma klawiatury numerycznej, więc nigdy jej nie wymagaj: sprawdzaj event.key, żeby obsłużyć cyfry z górnego rzędu i z klawiatury numerycznej.

Wpisanie liczby w polu uruchamia twój skrót

Skróty jednoklawiszowe, takie jak 1 do 9, uruchamiają się też wtedy, gdy ktoś pisze w polu. Pomiń zdarzenie klawiatury, jeśli pochodzi z pola formularza lub edytowalnego elementu:

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