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
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
- Na telefonie najpierw dotknij pola oznaczonego Pole tekstowe. Naciśnij dowolny klawisz.
- Odczytaj jego nazwę oraz event.key, event.code i keyCode.
- 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
| Klawisz | event.code | event.key | keyCode | keyCode w Firefoksie |
|---|---|---|---|---|
| Backspace | Backspace | Backspace | 8 | |
| Tab | Tab | Tab | 9 | |
| Enter | Enter | Enter | 13 | |
| Num Enter | NumpadEnter | Enter | 13 | |
| Lewy Shift | ShiftLeft | Shift | 16 | |
| Prawy Shift | ShiftRight | Shift | 16 | |
| Lewy Ctrl | ControlLeft | Control | 17 | |
| Prawy Ctrl | ControlRight | Control | 17 | |
| Lewy Alt | AltLeft | Alt | 18 | |
| Prawy Alt (AltGr) | AltRight | Alt | 18 | |
| Pause | Pause | Pause | 19 | |
| Caps Lock | CapsLock | CapsLock | 20 | |
| Esc | Escape | Escape | 27 | |
| Spacja | Space | " " | 32 | |
| Page Up | PageUp | PageUp | 33 | |
| Page Down | PageDown | PageDown | 34 | |
| End | End | End | 35 | |
| Home | Home | Home | 36 | |
| Strzałka w lewo | ArrowLeft | ArrowLeft | 37 | |
| Strzałka w górę | ArrowUp | ArrowUp | 38 | |
| Strzałka w prawo | ArrowRight | ArrowRight | 39 | |
| Strzałka w dół | ArrowDown | ArrowDown | 40 | |
| Print Screen | PrintScreen | PrintScreen | 44 | |
| Insert | Insert | Insert | 45 | |
| Delete | Delete | Delete | 46 | |
| 0 do 9 | Digit0 do Digit9 | 0 do 9 | 48 do 57 | |
| A do Z | KeyA do KeyZ | a do z | 65 do 90 | |
| Lewy Windows | MetaLeft | Meta | 91 | |
| Menu kontekstowe | ContextMenu | ContextMenu | 93 | |
| Num 0 do Num 9 | Numpad0 do Numpad9 | 0 do 9 | 96 do 105 | |
| Num * | NumpadMultiply | * | 106 | |
| Num + | NumpadAdd | + | 107 | |
| Num - | NumpadSubtract | - | 109 | |
| Num . | NumpadDecimal | . | 110 | |
| Num / | NumpadDivide | / | 111 | |
| F1 do F12 | F1 do F12 | F1 do F12 | 112 do 123 | |
| Num Lock | NumLock | NumLock | 144 | |
| Scroll Lock | ScrollLock | ScrollLock | 145 | |
| Wycisz | AudioVolumeMute | AudioVolumeMute | 173 | 181 |
| Ciszej | AudioVolumeDown | AudioVolumeDown | 174 | 182 |
| Głośniej | AudioVolumeUp | AudioVolumeUp | 175 | 183 |
| Średnik | Semicolon | ; | 186 | 59 |
| Równa się | Equal | = | 187 | 61 |
| Przecinek | Comma | , | 188 | |
| Minus | Minus | - | 189 | 173 |
| Kropka | Period | . | 190 | |
| Ukośnik | Slash | / | 191 | |
| Grawis (`) | Backquote | ` | 192 | |
| Lewy nawias kwadratowy | BracketLeft | [ | 219 | |
| Ukośnik wsteczny (\) | Backslash | \ | 220 | |
| Prawy nawias kwadratowy | BracketRight | ] | 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.