Kod klawisza (keycode)

Naciśnij dowolny klawisz, aby zobaczyć jego nazwę i każdy kod, który dostaje przeglądarka.

Naciśnij dowolny klawisz, aby zobaczyć jego kody.

Naciśnij dowolny klawisz

event.keyCo klawisz wpisuje lub robi
…
event.codeKtóry to klawisz: jego miejsce na klawiaturze
…
event.keyCodePrzestarzały kod liczbowy, wciąż wysyłany
…

Wpisz coś tutaj, aby zobaczyć, co wysyła klawiatura ekranowa lub metoda wprowadzania tekstu.

Wszystkie szczegóły zdarzenia

event.which
…Ta sama liczba co w keyCode. Używanie event.which też nie jest już zalecane.
event.location
…Odróżnia lewy klawisz od prawego i pokazuje, czy klawisz należy do klawiatury numerycznej.
Klawisze modyfikujące
…Przytrzymane razem z tym klawiszem: ctrlKey, shiftKey, altKey, metaKey.
event.repeat
…true, gdy przytrzymanie klawisza powtarza naciśnięcie.
event.isComposing
…true, gdy mechanizm wprowadzania tekstu tworzy znak, na przykład w języku chińskim, japońskim lub koreańskim.
W twoim układzie
…Co ten klawisz wpisuje w twoim układzie klawiatury, bez Shift (Keyboard Map API). Może pokazać układ główny, a nie ten, którego używasz.
getModifierState()
…Każdy modyfikator i każda blokada, które zgłasza przeglądarka. Wyłączone może też znaczyć, że przeglądarka tego nie zgłasza.

Kod do użycia

Dopasuj klawisz według

Ten sam klawisz w każdym układzie klawiatury. Najlepsze do gier i skrótów.

Naciśnij klawisz, a jego kod pojawi się tutaj.

Dziennik zdarzeń (brak zdarzeń)

Zdarzenia pojawią się tu po naciśnięciu klawisza.

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

Szybki start

  1. Na telefonie najpierw dotknij pola oznaczonego Pole tekstowe. Naciśnij dowolny klawisz.
  2. Odczytaj jego nazwę oraz event.key, event.code i keyCode.
  3. Naciśnij Kopiuj obok wartości albo Kopiuj kod, aby skopiować fragment kodu.

Jak czytać wyniki

Co widzisz Co to znaczy
Duży klawisz Naciśnięty klawisz, z nazwą, razem z przytrzymanymi klawiszami modyfikującymi: Lewy Shift, Ctrl + S, Num Enter.
event.key To, co klawisz wpisuje lub robi: „a”, „A” z Shift, „Enter”, „ArrowUp”. Zmienia się z układem klawiatury i z klawiszem Shift.
event.code Który to klawisz: jego miejsce na klawiaturze, na przykład „KeyA” lub „ShiftRight”. Taki sam w każdym układzie.
event.keyCode Stary numer klawisza, na przykład 65 dla A. Jest przestarzały, ale przeglądarki nadal go wysyłają.
event.location 0 dla większości klawiszy, 1 dla lewego klawisza, 2 dla prawego, 3 dla klawiatury numerycznej.
Klawisze modyfikujące Które z klawiszy Ctrl, Shift, Alt i Meta (klawisz Windows lub Cmd) były przytrzymane.
W twoim układzie Co klawisz wpisuje w twoim układzie klawiatury, bez Shift. Potrafią to ustalić tylko Chrome i Edge na komputerze.
getModifierState() Każdy modyfikator i blokada, które zgłasza przeglądarka, na przykład Caps Lock i Num Lock, włączone lub wyłączone.
Dziennik zdarzeń Każde zdarzenie keydown, keyup i tekstowe, najnowsze na górze.

Której wartości użyć?

  • event.code dla klawiszy, w których liczy się położenie: sterowanie w grach (WASD), skróty, pianino na klawiaturze.
  • event.key dla klawiszy, w których liczy się znaczenie: Enter, Escape, strzałki albo wpisywany znak, na przykład „?”.
  • Nie używaj keyCode ani which w nowym kodzie. Są przestarzałe i różnią się między przeglądarkami.

Wskazówka: W sekcji Kod do użycia narzędzie pisze kod JavaScript dla ostatnio naciśniętego klawisza, razem z przytrzymanymi klawiszami modyfikującymi.

Tabela kodów klawiszy

Kody klawiszy w amerykańskim układzie klawiatury, z nazwami klawiszy Windows. W innych układach klawisze interpunkcyjne mogą wysyłać inne liczby keyCode.
Klawiszevent.codeevent.keykeyCodekeyCode w Firefoksie
BackspaceBackspaceBackspace8
TabTabTab9
EnterEnterEnter13
Num EnterNumpadEnterEnter13
Lewy ShiftShiftLeftShift16
Prawy ShiftShiftRightShift16
Lewy CtrlControlLeftControl17
Prawy CtrlControlRightControl17
Lewy AltAltLeftAlt18
Prawy Alt (AltGr)AltRightAlt18
PausePausePause19
Caps LockCapsLockCapsLock20
EscEscapeEscape27
SpacjaSpace" "32
Page UpPageUpPageUp33
Page DownPageDownPageDown34
EndEndEnd35
HomeHomeHome36
Strzałka w lewoArrowLeftArrowLeft37
Strzałka w góręArrowUpArrowUp38
Strzałka w prawoArrowRightArrowRight39
Strzałka w dółArrowDownArrowDown40
Print ScreenPrintScreenPrintScreen44
InsertInsertInsert45
DeleteDeleteDelete46
0 do 9Digit0 do Digit90 do 948 do 57
A do ZKeyA do KeyZa do z65 do 90
Lewy WindowsMetaLeftMeta91
Menu kontekstoweContextMenuContextMenu93
Num 0 do Num 9Numpad0 do Numpad90 do 996 do 105
Num *NumpadMultiply*106
Num +NumpadAdd+107
Num -NumpadSubtract-109
Num .NumpadDecimal.110
Num /NumpadDivide/111
F1 do F12F1 do F12F1 do F12112 do 123
Num LockNumLockNumLock144
Scroll LockScrollLockScrollLock145
WyciszAudioVolumeMuteAudioVolumeMute173181
CiszejAudioVolumeDownAudioVolumeDown174182
GłośniejAudioVolumeUpAudioVolumeUp175183
ŚrednikSemicolon;18659
Równa sięEqual=18761
PrzecinekComma,188
MinusMinus-189173
KropkaPeriod.190
UkośnikSlash/191
Grawis (`)Backquote`192
Lewy nawias kwadratowyBracketLeft[219
Ukośnik wsteczny (\)Backslash\220
Prawy nawias kwadratowyBracketRight]221
Apostrof (')Quote'222

Zmiana przypisania klawisza

Aplikacje do zmiany przypisania klawiszy używają własnych nazw, więc nie wklejasz do nich tych wartości. Użyj nazwy dużego klawisza i event.code, aby mieć pewność, który to klawisz. Potem wybierz klawisz w aplikacji. W PowerToys Keyboard Manager i Karabiner-Elements możesz po prostu nacisnąć klawisz, aby go wybrać.

Jeśli coś jest nie tak

Nic się nie pokazuje po naciśnięciu klawisza

Najpierw kliknij pole klawiszy. Narzędzie wykrywa też naciśnięcia poza tym polem, ale tylko wtedy, gdy pole klawiszy jest widoczne na ekranie. Pomija klawisze używane w wyszukiwarce w menu i w innych polach tekstowych.

Klawisz w ogóle nic nie pokazuje

Klawiatura lub komputer zatrzymuje niektóre klawisze dla siebie, więc przeglądarka nigdy ich nie dostaje. Tak działają Fn, klawisze jasności i wiele klawiszy multimedialnych. Żadna strona nie widzi tych klawiszy.

W Windows klawisz Print Screen wysyła tylko keyup, więc pojawia się dopiero po jego puszczeniu.

Skrót zamknął kartę albo otworzył okno

Przeglądarki zatrzymują niektóre skróty: Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up, Ctrl + Page Down i od Ctrl + 1 do Ctrl + 9 w Windows oraz Cmd + N, Cmd + T, Cmd + W i Cmd + Q na Macu. Komputer zatrzymuje inne, takie jak Alt + F4, Windows + L i Ctrl + Alt + Del. Sam klawisz Windows otwiera menu Start. Strona nigdy nie dostaje tych klawiszy. Inne skróty, takie jak Ctrl + S lub F5, pokazują się w polu klawiszy i nic nie robią.

W telefonie z Androidem klawisz to „Unidentified”, a keyCode to 229

Klawiatura na ekranie nie mówi stronom, którego klawisza dotknięto. Wysyła tylko tekst. Poszukaj w dzienniku zdarzeń zdarzenia input: jego dane pokazują, co wpisano (przy usuwaniu pole data jest puste, a pole inputType mówi, co się stało). Aby zobaczyć prawdziwe kody klawiszy, podłącz klawiaturę Bluetooth lub USB.

iPhone’y zwykle przekazują informację o tym, który klawisz naciśnięto, i keyCode, ale event.code jest często pusty.

Pisanie po chińsku, japońsku lub koreańsku pokazuje keyCode 229

Twoja metoda wprowadzania buduje każdy znak z kilku klawiszy, więc klawisze pokazują keyCode 229 albo key „Process”, a isComposing ma wartość true, gdy to trwa. Przeglądarki różnią się przy pierwszym i ostatnim klawiszu. Odczytaj gotowy tekst ze zdarzenia compositionend lub input. Więcej w artykule keyCode 229 i klawisze „Unidentified”.

Klawisz pokazuje „Dead”

To martwy klawisz: czeka na twój następny klawisz, by dodać do niego akcent, na przykład ´ a potem e daje é. Mają je układy z akcentami. Pole klawiszy pokazuje, który to klawisz. Aby zobaczyć literę ze znakiem diakrytycznym, kliknij pole oznaczone Pole tekstowe i naciśnij kolejno oba klawisze.

AltGr włącza też Ctrl i Alt

W Windows AltGr działa jak Ctrl i Alt razem. Chrome i Edge najpierw wysyłają keydown dla Left Control, potem Right Alt, a ctrlKey i altKey są oba true. getModifierState(“AltGraph”) też jest true, ale Ctrl + Alt może być uznane za AltGr, więc ta metoda nie zawsze je rozróżni. Ma to znaczenie na polskiej klawiaturze (programisty), na której polskie litery wpisujesz z AltGr.

Klawisz wpisuje zły znak

Jeśli event.code jest dobry, a event.key zły, komputer używa innego układu klawiatury. Zmień go w ustawieniach języka lub klawiatury komputera. Jeśli event.code też jest zły, coś zmienia przypisanie klawisza: aplikacja do zmiany przypisania albo oprogramowanie klawiatury.

Na Macu klawisze naciśnięte z Cmd nie pokazują keyup

macOS nie wysyła keyup klawiszy naciśniętych przy przytrzymanym Cmd, więc przeglądarki nie zawsze mogą go zgłosić.

keyCode jest inny w innej przeglądarce

Firefox zwykle wysyła inne liczby dla kilku klawiszy, na przykład 59 dla klawisza ;, gdzie Chrome na klawiaturze amerykańskiej wysyła 186. Klawisze interpunkcji zmieniają się też z układem klawiatury. Użyj zamiast tego event.code lub event.key.

Jak działa ten test

Gdy naciskasz klawisz, przeglądarka wysyła stronie zdarzenie keydown, a po puszczeniu zdarzenie keyup. Narzędzie pokazuje wartości dokładnie tak, jak wysłała je przeglądarka. Nic nie jest zmieniane ani zgadywane, poza nazwą klawisza, która pochodzi z event.code.

Wewnątrz pola klawiszy narzędzie wstrzymuje zwykłe działanie każdego klawisza, więc F5 lub Ctrl + S pokazują swoje kody zamiast odświeżać stronę lub zapisywać. Naciśnij Esc, a potem Tab, aby opuścić pole klawiszy.

Pole tekstowe pokazuje to, co wysyła klawiatura ekranowa lub metoda wprowadzania. Tekst pojawia się tam jak zwykle, a dziennik zdarzeń wymienia też zdarzenia beforeinput, input i composition.

Co narzędzie widzi

  • Każdy klawisz, który przeglądarka przekazuje stronie, ze wszystkimi wartościami.
  • Co klawisz wpisuje w twoim układzie, w Chrome i Edge na komputerze (Keyboard Map API). Może pokazać twój główny układ zamiast tego, którego używasz.

Czego nie widzi

  • Klawiszy, które klawiatura lub komputer zatrzymują dla siebie, takich jak Fn.
  • Skrótów, które zatrzymuje przeglądarka lub komputer, takich jak Ctrl + W lub Alt + F4.
  • Kodów skanowania i kodów wirtualnych klawiszy Windows.

Na stronie jak testujemy klawiatury przeczytasz, skąd biorą się nasze ograniczenia i czego przeglądarka nie potrafi zmierzyć.

Pytania i odpowiedzi

Co to jest keycode?

Keycode mówi stronie internetowej, który klawisz naciśnięto. Przeglądarka wysyła go z każdym naciśnięciem klawisza, na przykład 13 dla Enter i 65 dla A.

Dziś są trzy wartości. event.key to to, co klawisz wpisuje lub robi. event.code to to, który to klawisz na klawiaturze. event.keyCode to stary numer, nadal wysyłany, ale przestarzały.

Jaka jest różnica między event.key a event.code?

event.code nazywa miejsce klawisza na klawiaturze, na przykład KeyQ dla klawisza na prawo od Tab. Jest taki sam w każdym układzie, więc nadaje się do gier (WASD) i skrótów.

event.key to to, co klawisz wpisuje: „q” na klawiaturze amerykańskiej, „a” na francuskiej, „Q” z Shift. Użyj go, gdy liczy się znak.

Czy keyCode jest przestarzały? Czego użyć zamiast niego?

Tak. keyCode, which i charCode są przestarzałe. Przeglądarki nadal je wysyłają, więc stary kod dalej działa, ale liczby różnią się między przeglądarkami i układami klawiatury. W nowym kodzie używaj event.key lub event.code.

Dlaczego dostaję keyCode 229?

229 oznacza, że klawisz przejęła metoda wprowadzania lub klawiatura ekranowa. Klawiatury w Androidzie wysyłają go prawie dla każdego klawisza, z event.key „Unidentified”. iPhone'y zwykle przekazują informację o tym, który klawisz naciśnięto. Przy pisaniu po japońsku, chińsku i koreańsku przeglądarka wysyła go, gdy znak jest jeszcze tworzony. Zamiast tego odczytaj tekst ze zdarzenia input.

Jaki klawisz naciskam?

Naciśnij go w polu klawiszy. Duży klawisz pokazuje jego nazwę, na przykład Prawy Alt (AltGr) lub Num Enter. Wartość event.code obok niego nazywa dokładny klawisz, taki sam w każdym układzie klawiatury.

Czy mogę zobaczyć kod skanowania (scan code) klawisza?

Nie. Przeglądarki nie przekazują stronom kodu skanowania ani kodu wirtualnego klawisza Windows. W Windows oba pokazuje okno Key History w programie AutoHotkey.

Czy ta strona zapisuje to, co piszę?

Nie. Strona pokazuje twoje naciśnięcia klawiszy tylko na twoim ekranie. Nie zapisuje ich ani nie wysyła.