KeyboardEvent: initKeyboardEvent()-Methode

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.initKeyboardEvent()-Methode initialisiert die Attribute eines Keyboard-Event-Objekts. Diese Methode wurde im Entwurf der DOM Level 3 Events eingeführt, jedoch in neueren Entwürfen abgelehnt. Gecko wird diese Funktion nicht unterstützen, da die Implementierung dieser Methode als experimentell bestehende Webanwendungen beeinträchtigte (siehe Firefox-Bug 999645). Webanwendungen sollten stattdessen einen Konstruktor verwenden, wenn dieser verfügbar ist.

Syntax

js
initKeyboardEvent(type, canBubble, cancelable,
                  view, key, location, ctrlKey,
                  altKey, shiftKey, metaKey)

Parameter

type

Der Typ des Keyboard-Events; Browser setzen diesen immer auf einen der Werte keydown, keypress oder keyup.

canBubble Optional

Gibt an, ob das Ereignis aufsteigen kann oder nicht. Standardmäßig false.

cancelable Optional

Gibt an, ob das Ereignis abgebrochen werden kann oder nicht. Standardmäßig false.

view Optional

Der WindowProxy, mit dem es verbunden ist. Standardmäßig null.

key Optional

Der Wert des key-Attributs. Standardmäßig "".

location Optional

Der Wert des location-Attributs. Standardmäßig 0.

ctrlKey Optional

Gibt an, ob der Steuerungstastenmodifikator aktiv ist. Standardmäßig false.

altKey Optional

Gibt an, ob der Alt-Tastenmodifikator aktiv ist. Standardmäßig false.

shiftKey Optional

Gibt an, ob der Umschalttastenmodifikator aktiv ist. Standardmäßig false.

metaKey Optional

Gibt an, ob der Meta-Tastenmodifikator aktiv ist. Standardmäßig false.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
UI Events
# dom-keyboardevent-initkeyboardevent

Die Spezifikation der KeyboardEvent-Schnittstelle durchlief zahlreiche Entwurfsstadien, zunächst unter DOM Events Level 2, wo sie verworfen wurde, da kein Konsens erzielt wurde, dann unter DOM Events Level 3. Dies führte zur Implementierung nicht-standardmäßiger Initialisierungsmethoden, der frühen DOM Events Level 2-Version, KeyboardEvent.initKeyEvent() durch Gecko-Browser und der frühen DOM Events Level 3-Version, KeyboardEvent.initKeyboardEvent() durch andere. Beide wurden durch die moderne Verwendung eines Konstruktors ersetzt: KeyboardEvent().

Browser-Kompatibilität