Element: keydown-Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("keydown", (event) => {});

onkeydown = (event) => {};

Ein KeyboardEvent. Erbt von UIEvent und Event.

Diese Schnittstelle erbt auch Eigenschaften ihrer Eltern, UIEvent und Event.

KeyboardEvent.altKey Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Taste Alt (Option oder ⌥ auf macOS) beim Generieren des Tastaturereignisses aktiv war.

KeyboardEvent.code Schreibgeschützt

Gibt einen String mit dem Codewert der physischen Taste zurück, die durch das Ereignis repräsentiert wird.

Warnung: Dies ignoriert das Tastaturlayout des Benutzers, sodass, wenn der Benutzer die Taste an der "Y"-Position in einem QWERTY-Tastaturlayout drückt (nahe der Mitte der Zeile oberhalb der Grundlinie), dies immer "KeyY" zurückgibt, auch wenn der Benutzer eine QWERTZ-Tastatur verwendet (was bedeuten würde, dass der Benutzer ein "Z" erwartet und alle anderen Eigenschaften ein "Z" anzeigen würden) oder ein Dvorak-Tastaturlayout (bei dem der Benutzer ein "F" erwartet). Wenn Sie die korrekten Tastenanschläge für den Benutzer anzeigen möchten, können Sie Keyboard.getLayoutMap() verwenden.

KeyboardEvent.ctrlKey Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Taste Ctrl beim Generieren des Tastaturereignisses aktiv war.

KeyboardEvent.isComposing Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn das Ereignis zwischen compositionstart und compositionend ausgelöst wird.

KeyboardEvent.key Schreibgeschützt

Gibt einen String zurück, der den Tastaturwert der durch das Ereignis repräsentierten Taste angibt.

KeyboardEvent.location Schreibgeschützt

Gibt eine Zahl zurück, die die Position der Taste auf der Tastatur oder einer anderen Eingabevorrichtung repräsentiert. Eine Liste der Konstanten, die die Positionen identifizieren, wird in Tastaturpositionen angezeigt.

KeyboardEvent.metaKey Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Meta-Taste (auf Mac-Tastaturen die ⌘ Command-Taste; auf Windows-Tastaturen die Windows-Taste (⊞)) beim Generieren des Tastaturereignisses aktiv war.

KeyboardEvent.repeat Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Taste so lange gedrückt gehalten wird, dass sie automatisch wiederholt wird.

KeyboardEvent.shiftKey Schreibgeschützt

Gibt einen booleschen Wert zurück, der true ist, wenn die Taste Shift beim Generieren des Tastaturereignisses aktiv war.

Dieses Beispiel protokolliert den Wert von KeyboardEvent.code, wann immer Sie eine Taste im Inneren eines <input>-Elements drücken.

<input placeholder="Click here, then press down a key." size="40" />
<p id="log"></p>

const input = document.querySelector("input");
const log = document.getElementById("log");

input.addEventListener("keydown", logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

Seit Firefox 65 werden die keydown- und keyup-Ereignisse nun während der Eingabe mit Eingabemethode ausgelöst, um die Browser-Kompatibilität für CJKT-Benutzer zu verbessern (Firefox Bug 354358). Um alle keydown-Ereignisse zu ignorieren, die Teil einer Komposition sind, können Sie etwa Folgendes tun (229 ist ein spezieller Wert, der für ein keyCode gesetzt wird, das mit einem IME verarbeitet wurde):

eventTarget.addEventListener("keydown", (event) => {
  if (event.isComposing || event.keyCode === 229) {
    return;
  }
  // do something
});

• input
• keypress
• keyup