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, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

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.