KeyboardEvent: keyCode-Eigenschaft

Wert von keyCode

Druckbare Tasten in Standardposition

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

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

Google Chrome, Chromium und Safari müssen den Wert aus dem Eingabezeichen ableiten. Wenn das eingegebene Zeichen mit der US-Tastaturbelegung eingegeben werden kann, verwenden sie den keyCode-Wert der US-Tastaturbelegung.

Firefox erhält keyCode-Werte aus ASCII-Zeichen, die über die Tastatur eingabefähig sind — sogar mit Shift-Modifikatoren oder einer ASCII-fähigen Tastaturbelegung. Siehe die folgenden Regeln für Details:

1. Wenn das System Windows ist und der native Tastencode der gedrückten Taste anzeigt, 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 anzeigt, dass die Taste 0-9 ist, verwenden Sie einen Tastencode dafür.
3. Wenn die gedrückte Taste ein ASCII-alphabetisches oder numerisches Zeichen ohne Modifikatortaste eingibt, verwenden Sie einen Tastencode dafür.
4. Wenn die gedrückte Taste ein ASCII-alphabetisches oder numerisches Zeichen 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. wenn die gedrückte Taste ein Unicode-Zeichen eingibt:
   1. Wenn die Tastaturbelegung 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. die Tastaturbelegung ist nicht ASCII-fähig, verwenden Sie die ASCII-fähige Tastaturbelegung, die im System mit der höchsten Priorität installiert ist:
      1. Wenn die gedrückte Taste auf der alternativen Tastaturbelegung ein ASCII-alphabetisches oder numerisches Zeichen eingibt, verwenden Sie einen Tastencode dafür.
      2. Andernfalls verwenden Sie 0 oder berechnen Sie mit den folgenden zusätzlichen Regeln.

Gecko legt keyCode-Werte von Interpunktionstasten, soweit möglich (wenn Punkte 7.1 oder 7.2 in der obigen Liste erreicht werden), mit den folgenden Regeln fest:

1. Wenn unter macOS oder Linux ausgeführt wird:

   1. Wenn die aktive Tastaturbelegung nicht ASCII-fähig ist und eine alternative ASCII-fähige Tastaturbelegung verfügbar ist.

      1. Wenn die alternative ASCII-fähige Tastaturbelegung ein ASCII-Zeichen nur mit der nicht modifizierten Taste erzeugt, verwenden Sie einen keyCode für das Zeichen.
      2. Wenn die alternative ASCII-fähige Tastaturbelegung ein ASCII-Zeichen mit einem Shift-Tastenmodifikator produziert, verwenden Sie einen keyCode für das Shift-Zeichen.
      3. Andernfalls verwenden Sie einen keyCode für ein ASCII-Zeichen, das von der Taste erzeugt wird, wenn die US-Tastaturbelegung aktiv ist.

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

2. Wenn unter Windows ausgeführt wird:

   1. Verwenden Sie einen keyCode-Wert für ein ASCII-Zeichen, das von einer Taste erzeugt wird, die dem gleichen virtuellen Tastencode von Windows zugeordnet ist, wenn die US-Tastaturbelegung aktiv ist.

[1] Der Wert wird von JIS-Tastatur eingegeben. Wenn Sie eine ANSI-Tastatur verwenden, sind der keyCode-Wert und das eingetippte Zeichen das, was Sie aus der US-Tastaturbelegung auswählen.

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

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

[4] Es werden keine Tastenevents ausgelöst.

[5] Die Taste ist nicht mit der griechischen Tastaturbelegung verfügbar (gibt kein Zeichen ein). Der Wert des keyup-Events ist 0x00 (0).

Nicht druckbare Tasten (Funktionstasten)

Beispiele

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

  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

Auf Windows sind einige Werte des virtuellen Keycodes für OEM-spezifische Tasten definiert (reserviert). Sie stehen für spezielle Tasten auf nicht standardisierten Tastaturen zur Verfügung. Mit anderen Worten, einige Werte werden von zwei oder mehr Anbietern (oder Hardware) für unterschiedliche Bedeutungen verwendet.

Ab Gecko 21 (und älter als 15) sind OEM-spezifische Tastenwerte nur auf Windows im keyCode Attribut verfügbar. Daher sind sie für übliche Webanwendungen nicht nützlich. Sie sind nur für Intranetanwendungen oder in ähnlichen Situationen nützlich.

Details finden Sie in "Herstellerspezifische Virtual-Key-Codes (Windows CE 5.0)" in MSDN unter Manufacturer-specific Virtual-Key Codes (Windows CE 5.0).