Kod klawisza Meta (klawisz Windows i Command)

Klawisz Windows i Cmd wysyłają event.key "Meta". keyCode lewego klawisza to 91, ale prawy klawisz i Firefox na Macu mają inne wartości.

Wszystkie wartości w skrócie

Klawisz Windows / Command (Meta) – wartości
Klawiszevent.codeevent.keykeyCodekeyCode na Macuevent.location
Lewy Windows / Lewy CommandMetaLeftMeta911 (Lewa strona)
Prawy Windows / Prawy CommandMetaRightMeta92932 (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 klawisz Windows lub Cmd

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

Kod, który reaguje na klawisz: Lewy Windows

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

Której wartości użyć

Dla skrótów na Macu sprawdzaj event.metaKey przy keydown drugiego klawisza. Ma wartość true, gdy przytrzymany jest Cmd (lub klawisz Windows). Połącz go z ctrlKey w skrótach, które mają działać w obu systemach.

Aby reagować na sam klawisz, sprawdź event.key === 'Meta' albo event.code: MetaLeft lub MetaRight. Te same nazwy obejmują klawisz Windows, klawisz command na Macu i klawisz Super w Linuksie.

Nie używaj keyCode dla tego klawisza. Lewy ma 91, ale Firefox na Macu wysyła 224 dla obu klawiszy, Firefox w Windows i Linuksie wysyła 91 dla obu, a prawy klawisz ma 92 w Windows i 93 w Chrome oraz Safari na Macu.

Co sprawia kłopoty

Na Macu keyup nigdy nie przychodzi dla klawiszy naciśniętych z przytrzymanym Cmd

macOS nie wysyła keyup klawiszy naciśniętych przy przytrzymanym Cmd: naciśnij Cmd + K, puść K, a strona nie dostanie keyup dla K. Przeglądarki nie mogą tego w pełni naprawić, bo macOS nie zgłasza puszczenia. W skrótach z Cmd nie polegaj na zdarzeniach keyup pozostałych klawiszy. Gdy przyjdzie keyup klawisza Meta, oznacz klawisze naciśnięte przy przytrzymanym Cmd jako puszczone.

keyCode 93 oznacza dwa różne klawisze

W Windows 93 to klawisz menu kontekstowego (event.code ContextMenu). W Chrome i Safari na Macu 93 to prawy klawisz Cmd. Użyj event.code, aby wiedzieć, który to klawisz.

Klawisz Windows otwiera zamiast tego menu Start

Sam klawisz Windows otwiera Start, a skróty Windows, takie jak Windows + D, Windows + L lub Windows + Tab, trafiają do systemu. Strona nie może ich zatrzymać. Start przejmuje fokus, więc zdarzenia keyup mogą nie dotrzeć do strony. Wyczyść zapisany stan przytrzymanych klawiszy po zdarzeniu blur okna. Nie buduj skrótów na klawiszu Windows.

Stary Firefox wysyła OS i OSLeft

Firefox przed wersją 118 wysyłał event.key OS dla klawisza Windows oraz event.code OSLeft i OSRight. Chrome używał OSLeft i OSRight przed wersją 52. Obecne przeglądarki wysyłają "Meta", "MetaLeft" i "MetaRight". Sprawdzaj stare nazwy tylko wtedy, gdy obsługujesz te wersje.

Skróty Cmd na Macu

Użytkownicy Maca oczekują Cmd tam, gdzie Windows używa Ctrl: Cmd + S do zapisu, Cmd + Z do cofania, Cmd + Shift + Z do ponowienia. Przyjmuj event.ctrlKey || event.metaKey i opisuj skrót na Macu jako Cmd + S lub ⌘S. Cmd + N, Cmd + T, Cmd + W i Cmd + Q należą do przeglądarki i nigdy nie docierają do strony.