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
| Klawisz | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| A | KeyA | a | 65 | 0 (Zwykły) |
| B | KeyB | b | 66 | 0 (Zwykły) |
| C | KeyC | c | 67 | 0 (Zwykły) |
| D | KeyD | d | 68 | 0 (Zwykły) |
| E | KeyE | e | 69 | 0 (Zwykły) |
| F | KeyF | f | 70 | 0 (Zwykły) |
| G | KeyG | g | 71 | 0 (Zwykły) |
| H | KeyH | h | 72 | 0 (Zwykły) |
| I | KeyI | i | 73 | 0 (Zwykły) |
| J | KeyJ | j | 74 | 0 (Zwykły) |
| K | KeyK | k | 75 | 0 (Zwykły) |
| L | KeyL | l | 76 | 0 (Zwykły) |
| M | KeyM | m | 77 | 0 (Zwykły) |
| N | KeyN | n | 78 | 0 (Zwykły) |
| O | KeyO | o | 79 | 0 (Zwykły) |
| P | KeyP | p | 80 | 0 (Zwykły) |
| Q | KeyQ | q | 81 | 0 (Zwykły) |
| R | KeyR | r | 82 | 0 (Zwykły) |
| S | KeyS | s | 83 | 0 (Zwykły) |
| T | KeyT | t | 84 | 0 (Zwykły) |
| U | KeyU | u | 85 | 0 (Zwykły) |
| V | KeyV | v | 86 | 0 (Zwykły) |
| W | KeyW | w | 87 | 0 (Zwykły) |
| X | KeyX | x | 88 | 0 (Zwykły) |
| Y | KeyY | y | 89 | 0 (Zwykły) |
| Z | KeyZ | z | 90 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'a') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'KeyA') {
// Twój kod tutaj
}
});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.