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 | event.code | event.key | keyCode | keyCode na Macu | event.location |
|---|---|---|---|---|---|
| Lewy Windows / Lewy Command | MetaLeft | Meta | 91 | 1 (Lewa strona) | |
| Prawy Windows / Prawy Command | MetaRight | Meta | 92 | 93 | 2 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Meta') {
// Twój kod tutaj
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'MetaLeft') {
// Twój kod tutaj
}
});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.