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

Werte für Windows-Taste / Command (Meta)
Tasteevent.codeevent.keykeyCodekeyCode am Macevent.location
Windows links / Command linksMetaLeftMeta911 (Linke Seite)
Windows rechts / Command rechtsMetaRightMeta92932 (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

Empfohlen: event.key prüfen
document.addEventListener('keydown', (event) => {
  if (event.key === 'Meta') {
    // Dein Code hier
  }
});
Platz der Taste prüfen: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'MetaLeft') {
    // Dein Code hier
  }
});
Alter Code, der noch keyCode nutzt (veraltet)
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.