KeyboardEvent: keyCode-Eigenschaft

Wert von keyCode

Druckbare Tasten in Standardposition

Der Wert von Tastenereignissen, die durch das Drücken oder Loslassen druckbarer Tasten in Standardposition verursacht werden, ist nicht zwischen Browsern kompatibel.

IE zeigt einfach den nativen virtuellen Tastencode-Wert als KeyboardEvent.keyCode an.

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

Firefox erhält keyCode-Werte aus ASCII-Zeichen, die durch die Taste eingegeben werden können — auch 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 Tastencode der gedrückten Taste angibt, dass die Taste a-z oder 0-9 ist, verwenden Sie einen Tastencode dafür.
2. Wenn das System Mac ist und der native Tastencode der gedrückten Taste angibt, dass die Taste 0-9 ist, verwenden Sie einen Tastencode dafür.
3. Wenn die gedrückte Taste ein ASCII-Alphabetiv- oder -Ziffernzeichen ohne Modifikatortaste eingibt, verwenden Sie einen Tastencode dafür.
4. Wenn die gedrückte Taste ein ASCII-Alphabetiv- oder -Ziffernzeichen mit einem Shift-Tastenmodifikator eingibt, verwenden Sie einen Tastencode dafür.
5. Wenn die gedrückte Taste ein anderes ASCII-Zeichen ohne Modifikatortaste eingibt, verwenden Sie einen Tastencode dafür.
6. Wenn die gedrückte Taste ein anderes ASCII-Zeichen mit einem Shift-Tastenmodifikator eingibt, verwenden Sie einen Tastencode dafür.
7. Andernfalls, d.h. gedrückte Taste gibt ein Unicode-Zeichen ein:
   1. Wenn das Tastaturlayout ASCII-fähig ist (d.h. ASCII-Alphabete eingeben kann), verwenden Sie 0 oder berechnen Sie mit den folgenden zusätzlichen Regeln.
   2. Andernfalls, d.h. das Tastaturlayout ist nicht ASCII-fähig, verwenden Sie das ASCII-fähige Tastaturlayout, das in der Umgebung mit der höchsten Priorität installiert ist:
      1. Wenn die gedrückte Taste auf dem alternativen Tastaturlayout ein ASCII-Alphabetiv- oder -Ziffernzeichen eingibt, verwenden Sie einen Tastencode dafür.
      2. Andernfalls verwenden Sie 0 oder berechnen Sie mit den folgenden zusätzlichen Regeln.

Gecko setzt keyCode-Werte von Interpunktionstasten so weit wie möglich (wenn Punkt 7.1 oder 7.2 in der obigen Liste erreicht wird) mit den folgenden Regeln:

1. Wenn macOS oder Linux ausgeführt wird:

   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 verschobene Zeichen.
      3. Andernfalls verwenden Sie einen keyCode für ein ASCII-Zeichen, das von der Taste erzeugt wird, wenn das US-Tastaturlayout aktiv ist.

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

2. Wenn auf Windows ausgeführt:

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

[1] Der Wert wird von der JIS-Tastatur eingegeben. Wenn Sie die ANSI-Tastatur verwenden, sind der Tastencode-Wert und das eingegebene Zeichen das, was Sie aus dem US-Tastaturlayout auswählen.

[2] Die Taste ist eine tote Taste. Der Wert des keyup-Ereignisses ist 0xBA (186).

[3] Die Taste ist eine tote Taste. Der Wert des keyup-Ereignisses ist 0x10 (16).

[4] Es werden keine Tastenereignisse ausgegeben.

[5] Die Taste ist mit dem griechischen Tastaturlayout nicht verfügbar (gibt keine Zeichen ein). Der Wert des keyup-Ereignisses ist 0x00 (0).

Nicht druckbare Tasten (Funktionstasten)

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();
  }
});