KeyboardEvent: initKeyEvent()-Methode

Warnung: Verwenden Sie diese Methode NICHT; Nutzen Sie stattdessen den KeyboardEvent() Konstruktor!

Die Methode wurde aus der DOM-Spezifikation entfernt und wird von keinem aktuellen Browser unterstützt. Firefox verbirgt diese Methode hinter der Einstellung (dom.keyboardevent.init_key_event.enabled) ab Version 93 und plant, sie kurz danach zu entfernen.

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die KeyboardEvent.initKeyEvent()-Methode wird verwendet, um den Wert eines Ereignisses zu initialisieren, das mit document.createEvent ("KeyboardEvent") erstellt wurde. Auf diese Weise initialisierte Ereignisse müssen mit der document.createEvent ("KeyboardEvent")-Methode erstellt worden sein. initKeyEvent() muss aufgerufen werden, um das Ereignis festzulegen, bevor es dispatched wird.

Syntax

initKeyEvent (type, bubbles, cancelable, view,
                    ctrlKey, altKey, shiftKey, metaKey,
                    keyCode, charCode)

Parameter

type: Ein String, der den Typ des Ereignisses repräsentiert.
bubbles: Ein boolescher Wert, der angibt, ob das Ereignis durch die Ereigniskette nach oben weitergereicht werden soll oder nicht (siehe bubbles).
cancelable: Ein boolescher Wert, der angibt, ob das Ereignis abgebrochen werden kann (siehe cancelable).
view: Gibt das UIEvent.view an; dieser Wert kann null sein.
ctrlKey: Ein boolescher Wert, der true ist, wenn der zu generierende virtuelle Schlüssel eine Kombination von Tasten enthält, die die Strg Taste enthalten.
altKey: Ein boolescher Wert, der true ist, wenn der zu generierende virtuelle Schlüssel eine Kombination von Tasten enthält, die die Alt Taste enthalten.
shiftKey: Ein boolescher Wert, der true ist, wenn der zu generierende virtuelle Schlüssel eine Kombination von Tasten enthält, die die Shift Taste enthalten.
metaKey: Ein boolescher Wert, der true ist, wenn der zu generierende virtuelle Schlüssel eine Kombination von Tasten enthält, die die Meta Taste enthalten.
keyCode: Ein unsigned long, der den virtuellen Tastencode-Wert der gedrückten Taste repräsentiert, sonst 0. Siehe KeyboardEvent.keyCode für die Liste der Tastencodes.
charCode: Ein unsigned long, der das Unicode-Zeichen, das mit der gedrückten Taste verbunden ist, repräsentiert, sonst 0.

Rückgabewert

Keiner (undefined).

Beispiele

const event = document.createEvent("KeyboardEvent"); // create a key event
// define the event
event.initKeyEvent(
  "keypress", // typeArg,
  true, // canBubbleArg,
  true, // cancelableArg,
  null, // viewArg, Specifies UIEvent.view. This value may be null.
  false, // ctrlKeyArg,
  false, // altKeyArg,
  false, // shiftKeyArg,
  false, // metaKeyArg,
  9, // keyCodeArg,
  0,
); // charCodeArg);

document.getElementById("blah").dispatchEvent(event);

Spezifikationen

Diese Implementierung von Tastaturereignissen basiert auf der Tastenereignis-Spezifikation in den frühen Versionen von DOM 2 Events, die später aus dieser Spezifikation entfernt wurde zugunsten von KeyboardEvent(), das stattdessen verwendet werden sollte.