Kody klawiszy liter (A–Z)

Klawisze liter wysyłają event.code od "KeyA" do "KeyZ", event.key od "a" do "z" na układzie US (od "A" do "Z" z Shift lub Caps Lock) i keyCode od 65 do 90.

Wszystkie wartości w skrócie

Litery A–Z – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
AKeyAa650 (Zwykły)
BKeyBb660 (Zwykły)
CKeyCc670 (Zwykły)
DKeyDd680 (Zwykły)
EKeyEe690 (Zwykły)
FKeyFf700 (Zwykły)
GKeyGg710 (Zwykły)
HKeyHh720 (Zwykły)
IKeyIi730 (Zwykły)
JKeyJj740 (Zwykły)
KKeyKk750 (Zwykły)
LKeyLl760 (Zwykły)
MKeyMm770 (Zwykły)
NKeyNn780 (Zwykły)
OKeyOo790 (Zwykły)
PKeyPp800 (Zwykły)
QKeyQq810 (Zwykły)
RKeyRr820 (Zwykły)
SKeySs830 (Zwykły)
TKeyTt840 (Zwykły)
UKeyUu850 (Zwykły)
VKeyVv860 (Zwykły)
WKeyWw870 (Zwykły)
XKeyXx880 (Zwykły)
YKeyYy890 (Zwykły)
ZKeyZz900 (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 litery

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

Kod, który reaguje na klawisz: A

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'a') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'KeyA') {
    // 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 === 65) {
    // Twój kod tutaj
  }
});

Której wartości użyć

To zależy od tego, czy ważna jest litera, czy miejsce na klawiaturze.

Dla wpisywanych liter i skrótów nazwanych od litery, jak Ctrl + Z do cofania, sprawdzaj event.key. Podąża za układem użytkownika, więc skrót działa na klawiszu, na którym widać Z.

Dla klawiszy wybieranych według miejsca, jak WASD w grze, sprawdzaj event.code. KeyW to klawisz nad S na każdym układzie, nawet na francuskiej klawiaturze AZERTY, gdzie wpisuje „z”.

keyCode to numer wielkiej litery: od 65 dla A do 90 dla Z, niezależnie od Shift. W układach opartych na alfabecie łacińskim zwykle odpowiada wpisanej literze: na AZERTY klawisz z kodem KeyQ wpisuje „a” i wysyła 65. Na układach rosyjskim, greckim i innych niełacińskich keyCode zwykle odpowiada literze z tego samego miejsca w układzie amerykańskim.

Co sprawia kłopoty

event.key to „A” zamiast „a”

Shift i Caps Lock zmieniają event.key. Przed porównaniem zamień event.key na małe litery: event.key.toLowerCase() === 'a', a event.shiftKey sprawdzaj osobno, jeśli Shift ma znaczenie. Pomaga to też na Macu, gdzie po naciśnięciu Cmd + Shift + Z wartość event.key może być małą literą „z”.

Sterowanie WASD nie działa na francuskiej klawiaturze

Jeśli sprawdzasz event.key === 'w', gracze z AZERTY muszą sięgać po W w lewym dolnym rogu. Sprawdzaj event.code (KeyW, KeyA, KeyS, KeyD), aby klawisze zostały w tym samym miejscu. Aby pokazać w pomocy właściwe litery, Chrome i Edge potrafią podać, co wpisuje dany kod: navigator.keyboard.getLayoutMap().

Ctrl+Z trafia w zły klawisz na niemieckiej lub francuskiej klawiaturze

Niemiecki QWERTZ zamienia Z i Y, a na AZERTY Z leży tam, gdzie na klawiaturze US jest W. Skrót sprawdzany przez event.code === 'KeyZ' każe Niemcom naciskać klawisz z napisem Y. Dopasowuj skróty z literami przez event.key.

Skróty przestają działać na układzie rosyjskim lub greckim

Tam event.key to litera tego alfabetu: Ctrl + Z na układzie rosyjskim wysyła „я”. Gdy event.key nie zawiera litery od A do Z, użyj event.code, który wskazuje położenie klawisza:

const letter = /^[a-z]$/i.test(event.key)
  ? event.key.toLowerCase()
  : event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';

Alt+litera wpisuje znak na Macu

Option + S wpisuje „ß”, więc event.key to „ß”, a nie „s”. Option + E to klawisz martwy: event.key to Dead, a następna litera dostaje akcent. Dopasowuj skróty z Alt przez event.code i event.altKey. W Windows układy z AltGr robią to samo z Ctrl + Alt: Ctrl + Alt + E wpisuje € na niemieckiej klawiaturze, a na polskiej Ctrl + Alt + E wpisuje „ę”, więc unikaj skrótów Ctrl + Alt + litera.