Meta-Tastencode (Windows-Taste und Command)
Die Windows-Taste und Cmd senden event.key „Meta“. Der keyCode ist links 91, aber die rechte Taste und Firefox am Mac weichen ab.
Alle Werte auf einen Blick
| Taste | event.code | event.key | keyCode | keyCode am Mac | event.location |
|---|---|---|---|---|---|
| Windows links / Command links | MetaLeft | Meta | 91 | 1 (Linke Seite) | |
| Windows rechts / Command rechts | MetaRight | Meta | 92 | 93 | 2 (Rechte Seite) |
keyCode so, wie Chrome und Edge ihn unter Windows senden. Die Mac-Spalte (Chrome und Safari am Mac) und die Firefox-Spalte zeigen nur Zahlen, die abweichen. Manche Tasten unterscheiden sich auch je nach System, wie der Text unten sagt. event.which ist immer dieselbe Zahl wie keyCode. event.key gilt für ein US-Layout ohne Umschalt.
Hier drücken
Klicke hier und drücke dann die Windows-Taste oder Cmd
Du nutzt nur die Tastatur? Drücke Esc und dann Tab, um das Tastenfeld zu verlassen.
Code, der auf Windows links reagiert
document.addEventListener('keydown', (event) => {
if (event.key === 'Meta') {
// Dein Code hier
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'MetaLeft') {
// Dein Code hier
}
});document.addEventListener('keydown', (event) => {
if (event.keyCode === 91) {
// Dein Code hier
}
});Welchen Wert du nutzen solltest
Prüfe für Mac-Kürzel event.metaKey beim keydown der anderen Taste. Es ist true, solange Cmd (oder die Windows-Taste) gedrückt ist. Kombiniere es mit ctrlKey für Kürzel, die auf beiden Systemen gehen sollen.
Willst du auf die Taste selbst reagieren, prüfe event.key === 'Meta' oder event.code: MetaLeft oder MetaRight. Dieselben Namen gelten für die Windows-Taste, die Mac-Taste command und die Super-Taste unter Linux.
Nimm für diese Taste nicht keyCode. Die linke Taste ist 91, aber Firefox am Mac sendet für beide Tasten 224, Firefox unter Windows und Linux sendet für beide 91, und die rechte Taste ist unter Windows 92, aber in Chrome und Safari am Mac 93.
Wo es oft hakt
Am Mac kommt für Tasten, die bei gehaltenem Cmd gedrückt wurden, nie ein keyup
macOS sendet kein keyup für Tasten, die bei gehaltenem Cmd gedrückt wurden: Drückst du Cmd + K und lässt K los, bekommt die Seite kein keyup für K. Browser können das nicht ganz beheben, weil macOS das Loslassen nicht meldet. Verfolge gehaltene Tasten nicht über Cmd-Kürzel. Kommt das keyup von Meta an, markiere die Tasten, die bei gehaltenem Cmd gedrückt wurden, als losgelassen.
keyCode 93 meint zwei verschiedene Tasten
Unter Windows ist 93 die Menütaste (event.code „ContextMenu“). In Chrome und Safari am Mac ist 93 die rechte Cmd-Taste. Nimm event.code, um zu wissen, welche du bekommen hast.
Die Windows-Taste öffnet stattdessen das Startmenü
Die Windows-Taste allein öffnet Start, und Windows-Kürzel wie Windows + D, Windows + L oder Windows + Tab gehen an das System. Die Seite kann sie nicht stoppen. Start nimmt den Fokus, darum können keyups fehlen: Setze gehaltene Tasten beim Ereignis blur des Fensters zurück. Baue keine Kürzel auf die Windows-Taste.
Alte Firefox-Versionen senden „OS“ und „OSLeft“
Firefox vor Version 118 sendete für die Windows-Taste event.key „OS“ und event.code „OSLeft“ und „OSRight“. Chrome nutzte vor Version 52 „OSLeft“ und „OSRight“. Aktuelle Browser senden "Meta", "MetaLeft" und "MetaRight". Prüfe die alten Namen nur, wenn du diese Versionen unterstützt.
Cmd-Kürzel am Mac
Am Mac erwartet man Cmd dort, wo Windows Strg nutzt: Cmd + S zum Speichern, Cmd + Z zum Rückgängigmachen, Cmd + Umschalt + Z zum Wiederholen. Akzeptiere event.ctrlKey || event.metaKey und beschrifte das Kürzel am Mac mit Cmd + S oder ⌘S. Cmd + N, Cmd + T, Cmd + W und Cmd + Q gehören dem Browser und erreichen die Seite nie.