Kody klawiszy klawiatury numerycznej

Cyfry klawiatury numerycznej wysyłają event.code od "Numpad0" do "Numpad9", event.key od "0" do "9" i keyCode od 96 do 105; operatory wysyłają od 106 do 111, a Num Lock 144.

Wszystkie wartości w skrócie

Klawiatura numeryczna – wartości
Klawiszevent.codeevent.keykeyCodekeyCode na Macuevent.location
Num 0Numpad00963 (Klawiatura numeryczna)
Num 1Numpad11973 (Klawiatura numeryczna)
Num 2Numpad22983 (Klawiatura numeryczna)
Num 3Numpad33993 (Klawiatura numeryczna)
Num 4Numpad441003 (Klawiatura numeryczna)
Num 5Numpad551013 (Klawiatura numeryczna)
Num 6Numpad661023 (Klawiatura numeryczna)
Num 7Numpad771033 (Klawiatura numeryczna)
Num 8Numpad881043 (Klawiatura numeryczna)
Num 9Numpad991053 (Klawiatura numeryczna)
Num *NumpadMultiply*1063 (Klawiatura numeryczna)
Num +NumpadAdd+1073 (Klawiatura numeryczna)
Num -NumpadSubtract-1093 (Klawiatura numeryczna)
Num .NumpadDecimal.1103 (Klawiatura numeryczna)
Num /NumpadDivide/1113 (Klawiatura numeryczna)
Num EnterNumpadEnterEnter133 (Klawiatura numeryczna)
Num Lock / ClearNumLockNumLock144120 (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 klawiatury numerycznej

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

Kod, który reaguje na klawisz: Num 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 === 'Numpad0') {
    // 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 === 96) {
    // Twój kod tutaj
  }
});

Której wartości użyć

Dla wpisywanych cyfr i operatorów sprawdzaj event.key. Wartości takie jak 1, + czy * są takie same na klawiaturze numerycznej i w głównej części klawiatury, więc wystarczy jedno sprawdzenie.

Użyj event.code (Numpad1, NumpadAdd) tylko wtedy, gdy klawiatura numeryczna ma robić coś własnego, na przykład sterować ruchem w ośmiu kierunkach w grze. event.location ma dla klawiszy klawiatury numerycznej wartość 3, co jest innym sposobem ich odróżnienia.

keyCode to od 96 do 105 dla cyfr, potem 106 dla *, 107 dla +, 109 dla -, 110 dla klawisza separatora dziesiętnego i 111 dla /. Enter z klawiatury numerycznej wysyła 13, tak jak główny Enter.

Co sprawia kłopoty

Przy wyłączonym Num Lock Numpad4 wysyła ArrowLeft

W Windows i Linuksie klawisze cyfr zamieniają się w klawisze nawigacji, gdy Num Lock jest wyłączony. Numpad4 wysyła wtedy event.key ArrowLeft i keyCode 37, ale event.code nadal ma wartość Numpad4. Numpad0 wysyła Insert, Numpad5 Clear (keyCode 12), a klawisz separatora dziesiętnego Delete. Jeśli brakuje cyfr, sprawdź event.getModifierState('NumLock') i poproś użytkownika o włączenie Num Lock.

Num Lock wysyła keyCode 12 na Macu

Klawiatury Maca mają w tym miejscu klawisz Clear, a klawiatura numeryczna zawsze wpisuje cyfry. Klawisz Clear zwraca NumLock w event.code, Clear w event.key i keyCode 12 zamiast 144.

Klawisz separatora dziesiętnego wpisuje przecinek

Na układzie niemieckim i wielu innych NumpadDecimal wpisuje przecinek. event.key to ,, a keyCode zwykle zostaje 110. Jeśli odczytujesz liczby, akceptuj zarówno kropkę, jak i przecinek. W Polsce część dziesiętną oddziela się przecinkiem, więc to ważne.

Klawiatura numeryczna Maca ma klawisz =

Pełnowymiarowe klawiatury Apple mają dodatkowy klawisz =: event.code NumpadEqual, event.key =. Nie ma go w tabeli powyżej, bo klawiatury PC rzadko go mają. Jego keyCode to 187 w Chrome i Safari na Macu oraz 61 w przeglądarce Firefox (a w Windows 12), więc dopasuj go przez key lub code.

Wiele klawiatur nie ma klawiatury numerycznej

Laptopy, kompaktowe klawiatury i telefony jej nie mają. Nigdy nie wymagaj klawiszy klawiatury numerycznej: przyjmuj też cyfry z górnego rzędu, co robi sprawdzanie event.key. Niektóre laptopy chowają klawiaturę numeryczną w klawiszach liter, włączaną przez Num Lock. Gdy jest włączona, te litery wysyłają kody klawiatury numerycznej.