KeyboardEvent: keyCode-Eigenschaft

Wert von keyCode

Druckbare Tasten in Standardposition

Der Wert von Tastenereignissen, die durch das Drücken oder Loslassen von druckbaren Tasten in Standardposition ausgelöst werden, ist zwischen den Browsern nicht kompatibel.

IE gibt einfach den nativen virtuellen Keycode-Wert als KeyboardEvent.keyCode aus.

Google Chrome, Chromium und Safari müssen den Wert aus dem Eingabezeichen ermitteln. Wenn das Eingabezeichen mit dem US-Tastaturlayout eingegeben werden kann, verwenden sie den keyCode-Wert auf dem US-Tastaturlayout.

Firefox erhält keyCode-Werte von ASCII-Zeichen, die durch die Taste eingegeben werden können — selbst mit Shift-Modifikatoren oder einem ASCII-fähigen Tastaturlayout. Siehe die folgenden Regeln für Details:

1. Wenn das System Windows ist und der native Keycode der gedrückten Taste darauf hinweist, dass die Taste a-z oder 0-9 ist, verwenden Sie einen Keycode dafür.
2. Wenn das System Mac ist und der native Keycode der gedrückten Taste darauf hinweist, dass die Taste 0-9 ist, verwenden Sie einen Keycode dafür.
3. Wenn die gedrückte Taste ein ASCII-alphabetisches oder numerisches Zeichen ohne Modifikatortaste eingibt, verwenden Sie einen Keycode dafür.
4. Wenn die gedrückte Taste ein ASCII-alphabetisches oder numerisches Zeichen mit einem Shift-Tastenmodifikator eingibt, verwenden Sie einen Keycode dafür.
5. Wenn die gedrückte Taste ein anderes ASCII-Zeichen ohne Modifikatortaste eingibt, verwenden Sie einen Keycode dafür.
6. Wenn die gedrückte Taste ein anderes ASCII-Zeichen mit einem Shift-Tastenmodifikator eingibt, verwenden Sie einen Keycode dafür.
7. Andernfalls, d.h. die gedrückte Taste gibt ein Unicode-Zeichen ein:
   1. Wenn das Tastaturlayout ASCII-fähig ist (d.h. ASCII-Alphabeten eingeben kann), verwenden Sie 0 oder berechnen Sie mit den folgenden zusätzlichen Regeln.
   2. Andernfalls, wenn das Tastaturlayout nicht ASCII-fähig ist, verwenden Sie das ASCII-fähige Tastaturlayout, das im System mit der höchsten Priorität installiert ist:
      1. Wenn die gedrückte Taste auf dem alternativen Tastaturlayout ein ASCII-alphabetisches oder numerisches Zeichen eingibt, verwenden Sie einen Keycode dafür.
      2. Andernfalls verwenden Sie 0 oder berechnen Sie mit den folgenden zusätzlichen Regeln.

Gecko setzt die keyCode-Werte von Satzzeichentasten, soweit möglich (wenn Punkt 7.1 oder 7.2 in der obigen Liste erreicht wird), mit den folgenden Regeln:

1. Bei macOS oder Linux:

   1. Wenn das aktive Tastaturlayout nicht ASCII-fähig ist und ein alternatives ASCII-fähiges Tastaturlayout verfügbar ist.

      1. Wenn das alternative ASCII-fähige Tastaturlayout ein ASCII-Zeichen nur über die unveränderte Taste erzeugt, verwenden Sie einen keyCode für das Zeichen.
      2. Wenn das alternative ASCII-fähige Tastaturlayout ein ASCII-Zeichen mit einem Shift-Tastenmodifikator erzeugt, verwenden Sie einen keyCode für das geänderte Zeichen.
      3. Andernfalls verwenden Sie einen keyCode für ein ASCII-Zeichen, das durch die Taste erzeugt wird, wenn das US-Tastaturlayout aktiv ist.

   2. Andernfalls verwenden Sie einen keyCode für ein ASCII-Zeichen, das durch die Taste erzeugt wird, wenn das US-Tastaturlayout aktiv ist.

2. Bei Windows:

   1. Verwenden Sie einen keyCode-Wert für ein ASCII-Zeichen, das durch eine Taste erzeugt wird, die auf denselben virtuellen Keycode von Windows abgebildet ist, wenn das US-Tastaturlayout aktiv ist.

Nicht druckbare Tasten (Funktionstasten)

[1] Auf Windows löst das Drücken der AltGraph-Taste sowohl die "ControlLeft"- als auch die "AltRight"-Tastenereignisse aus.

[2] Wenn das japanische Tastaturlayout aktiv ist, löst das Drücken der CapsLock-Taste ohne Drücken von Shift 0xF0 (240) aus. Die Taste funktioniert als Alphanumeric-Taste mit dem Label "英数".

[3] Wenn das japanische Tastaturlayout aktiv ist, löst das Drücken der "CapsLock"-Taste ohne Drücken von Shift 0x00 (0) aus. Die Taste funktioniert als "Alphanumeric"-Taste mit dem Label "英数".

Konstanten für den keyCode-Wert

Gecko definiert viele keyCode-Werte in KeyboardEvent, um die Zuordnungstabelle explizit zu machen. Diese Werte sind für Add-on-Entwickler von Firefox nützlich, aber nicht so nützlich auf öffentlichen Webseiten.

Beispiele

window.addEventListener("keydown", (event) => {
  if (event.defaultPrevented) {
    return; // Should do nothing if the default action has been cancelled
  }

  let handled = false;
  if (event.key !== undefined) {
    // Handle the event with KeyboardEvent.key
    handled = true;
  } else if (event.keyCode !== undefined) {
    // Handle the event with KeyboardEvent.keyCode
    handled = true;
  }

  if (handled) {
    // Suppress "double action" if event handled
    event.preventDefault();
  }
});

Spezifikationen

Browser-Kompatibilität

OEM-spezifische Tasten auf Windows

Unter Windows sind einige Werte des virtuellen Keycodes für OEM-spezifische Tasten definiert (reserviert). Diese sind für spezielle Tasten auf nicht standardmäßigen Tastaturen verfügbar. Mit anderen Worten, einige Werte werden von zwei oder mehr Anbietern (oder Hardware) für unterschiedliche Bedeutungen genutzt.

Beginnend mit Gecko 21 (und älter als 15) sind OEM-spezifische Tastaturwerte nur auf Windows in der keyCode-Eigenschaft verfügbar. Daher sind sie nicht nützlich für gewöhnliche Webanwendungen. Sie sind nur für Intranet-Anwendungen oder in ähnlichen Situationen nützlich.

Sehen Sie "Herstellerspezifische virtuelle Schlüsselcodes (Windows CE 5.0)" in MSDN für weitere Details.