Kod klawisza Control

Oba klawisze Ctrl wysyłają event.key "Control" i keyCode 17. Lewy od prawego odróżnisz tylko po event.code i event.location.

Wszystkie wartości w skrócie

Control – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
Lewy CtrlControlLeftControl171 (Lewa strona)
Prawy CtrlControlRightControl172 (Prawa strona)

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 Control

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

Kod, który reaguje na klawisz: Lewy Ctrl

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

Której wartości użyć

Do skrótów sprawdzaj event.ctrlKey przy keydown drugiego klawisza. Ma wartość true, gdy przytrzymany jest którykolwiek Ctrl, więc nie musisz samodzielnie śledzić Ctrl.

Aby reagować na sam Ctrl, sprawdź event.key === 'Control'. Oba klawisze go wysyłają, z keyCode 17. Do odróżnienia ich użyj event.code (ControlLeft lub ControlRight) albo event.location (1 lewy, 2 prawy). Wiele laptopów w ogóle nie ma prawego Ctrl.

Na Macu klawisz z napisem control wysyła te same wartości. Ale skróty na Macu używają Cmd, czyli metaKey, a nie ctrlKey.

Co sprawia kłopoty

Skrót działa w Windows, ale nie na Macu

Użytkownicy Maca naciskają Cmd + S, a nie Ctrl + S. Obsłuż oba:

if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 's') {
  event.preventDefault();
  save();
}

Pokaż też właściwy opis: Ctrl + S w Windows i Linuksie, Cmd + S lub ⌘S na Macu.

Ctrl pojawia się, gdy ktoś wpisuje @ lub € przez AltGr

W Windows AltGr działa jak Ctrl i Alt naraz. Chrome i Edge wysyłają najpierw keydown lewego Ctrl, potem prawego Alt, a przy wpisywanym klawiszu ctrlKey i altKey mają wartość true. Skrót Ctrl + Alt + litera może się więc uruchomić, gdy ktoś wpisuje „ą” na polskiej klawiaturze albo „@” na niemieckiej. Unikaj skrótów z Ctrl + Alt albo pomijaj klawisze, których event.key jest innym znakiem niż spodziewana litera.

Ctrl+W, Ctrl+T, Ctrl+N i Ctrl+Tab nie da się zablokować

Przeglądarka je przejmuje: w Windows Ctrl + N, Ctrl + T, Ctrl + W, Ctrl + Tab, Ctrl + Page Up i Ctrl + Page Down. W Chrome i Edge strona nie dostaje keydown, a Firefox może wysłać keydown, ale preventDefault() w żadnej z nich nie powstrzyma przeglądarki. Wybierz inne skróty. Ctrl + S, Ctrl + P i Ctrl + F docierają, a preventDefault() zatrzymuje własną akcję przeglądarki.

Ctrl+kliknięcie otwiera menu na Macu

Na Macu Control + kliknięcie to kliknięcie prawym przyciskiem: przeglądarka wywołuje contextmenu. Na Macu nie używaj Ctrl + kliknięcia do dodawania elementów do zaznaczenia. Użyj tam Cmd + kliknięcia (metaKey), jak w aplikacjach Maca.

Ctrl+przewijanie powiększa stronę

Przytrzymanie Ctrl podczas przewijania kółkiem myszy zmienia powiększenie strony. Tak samo działa zsuwanie i rozsuwanie dwóch palców na touchpadzie: Chrome, Edge i Firefox zgłaszają ten gest jako zdarzenie wheel z Ctrl, czyli z ctrlKey równym true. Wywołaj preventDefault() tylko wtedy, gdy twoja mapa lub element canvas ma własne powiększanie, i zarejestruj funkcję obsługującą wheel z opcją { passive: false }.