Kody klawiszy funkcyjnych (F1–F24)

F1 do F12 wysyłają event.key i event.code "F1" do "F12" oraz keyCode 112 do 123. F13–F24 mają dalej kody keyCode od 124 do 135.

Wszystkie wartości w skrócie

Klawisze funkcyjne – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
F1F1F11120 (Zwykły)
F2F2F21130 (Zwykły)
F3F3F31140 (Zwykły)
F4F4F41150 (Zwykły)
F5F5F51160 (Zwykły)
F6F6F61170 (Zwykły)
F7F7F71180 (Zwykły)
F8F8F81190 (Zwykły)
F9F9F91200 (Zwykły)
F10F10F101210 (Zwykły)
F11F11F111220 (Zwykły)
F12F12F121230 (Zwykły)
F13F13F131240 (Zwykły)
F14F14F141250 (Zwykły)
F15F15F151260 (Zwykły)
F16F16F161270 (Zwykły)
F17F17F171280 (Zwykły)
F18F18F181290 (Zwykły)
F19F19F191300 (Zwykły)
F20F20F201310 (Zwykły)
F21F21F211320 (Zwykły)
F22F22F221330 (Zwykły)
F23F23F231340 (Zwykły)
F24F24F241350 (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 funkcyjny

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

Kod, który reaguje na klawisz: F1

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

Której wartości użyć

Sprawdzaj event.key === 'F2' (albo inny potrzebny numer). W klawiszach funkcyjnych event.key i event.code to ten sam tekst, od "F1" do "F24", w każdym układzie klawiatury, więc działa jedno i drugie.

keyCode biegnie od 112 dla F1 do 123 dla F12, a potem dalej do 135 dla F24. Nadal dociera, ale jest wycofywany, a starsze przeglądarki na Macu wysyłały 0 dla F21 do F24 (patrz niżej).

Pomyśl o użytkownikach, którym trudno nacisnąć klawisz funkcyjny. Laptopy i klawiatury Maca umieszczają jasność, głośność i sterowanie multimediami na tych samych klawiszach, a wiele małych klawiatur nie ma rzędu F w ogóle. Do każdego skrótu z klawiszem F dodaj drugi sposób, na przykład przycisk albo skrót z literą.

Co sprawia kłopoty

F5 odświeża stronę, a F12 otwiera narzędzia deweloperskie

Przeglądarka ma własne zadanie dla większości klawiszy funkcyjnych. W Chrome w Windows: F1 otwiera pomoc, F3 otwiera wyszukiwanie na stronie, F5 odświeża, F6 przeskakuje do paska adresu, F7 włącza przeglądanie z kursorem, F10 przenosi fokus na pasek narzędzi, F11 włącza pełny ekran, a F12 otwiera narzędzia deweloperskie. Wywołanie event.preventDefault() w keydown zatrzymuje wiele z nich, na przykład F5, ale nie wszystkie. Gdy przeglądarka jest w pełnym ekranie, F11, który z niego wychodzi, nigdy nie dociera do strony. Nie buduj niczego ważnego na F5, F11 ani F12.

Naciśnięcie F5 zmienia głośność

W wielu laptopach górny rząd najpierw pełni funkcje multimedialne, a F1 do F12 wymagają klawisza Fn. Wtedy przeglądarka otrzymuje zdarzenie klawisza multimedialnego, na przykład AudioVolumeUp (keyCode 175), a klawisze jasności mogą w ogóle nie wysłać zdarzenia. Wiele laptopów ma blokadę Fn, często Fn + Esc, albo ustawienie, które to zamienia. Twoja strona nie może tego zmienić, więc powiedz użytkownikom, żeby przytrzymali Fn.

Na Macu klawisze F zmieniają ekran i dźwięk

Na klawiaturze Maca górny rząd domyślnie steruje jasnością, głośnością i innymi funkcjami, chyba że użytkownik przytrzyma fn albo włączy w ustawieniach klawiatury opcję „Używaj klawiszy F1, F2 itd. jako standardowych klawiszy funkcyjnych”. Nawet wtedy macOS zachowuje niektóre dla siebie: F11 może pokazać biurko. Użytkownicy Maca spodziewają się też skrótów z Cmd, na przykład Cmd + R do odświeżenia, bardziej niż klawiszy F.

Alt+F4 i Ctrl+F4 nigdy nie docierają do strony

W Windows Alt + F4 zamyka okno, a Ctrl + F4 zamyka kartę w Chrome i Edge. Przeglądarka przechwytuje je, zanim zadziała twoja funkcja obsługi zdarzenia. Nie używaj ich jako skrótów.

F21 do F24 nie działają na Macu

macOS nie ma klawiszy powyżej F20, a starsze wersje Chrome i Safari wysyłały keyCode 0 dla F21 do F24. Nie polegaj na tych klawiszach na Macu. Klawisze powyżej F12 istnieją tylko na niektórych klawiaturach: pełnowymiarowe klawiatury Apple sięgają F19, a makropady i klawiatury do gier często wysyłają F13 do F24, bo nie używa ich żadna inna aplikacja.