MouseEvent: initMouseEvent()-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 Methode MouseEvent.initMouseEvent() initialisiert den Wert eines Mausereignisses, nachdem es erstellt wurde (normalerweise mit der Methode Document.createEvent()).

Warnung: Verwenden Sie diese Methode nicht mehr, da sie veraltet ist.

Stattdessen sollten Sie spezifische Event-Konstruktoren verwenden, wie zum Beispiel MouseEvent(). Die Seite über Erstellen und Auslösen von Events bietet weitere Informationen zur Verwendung.

Ereignisse, die auf diese Weise initialisiert werden, müssen mit der Methode Document.createEvent() erstellt worden sein. Diese Methode muss aufgerufen werden, um das Ereignis festzulegen, bevor es mit EventTarget.dispatchEvent() ausgelöst wird.

Syntax

initMouseEvent(type, canBubble, cancelable, view,
                     detail, screenX, screenY, clientX, clientY,
                     ctrlKey, altKey, shiftKey, metaKey,
                     button, relatedTarget)

Parameter

type: der String, der den type des Ereignisses setzt. Mögliche Typen für Mausereignisse sind: click, mousedown, mouseup, mouseover, mousemove, mouseout.
canBubble: ob das Ereignis bubblen kann oder nicht. Setzt den Wert von Event.bubbles.
cancelable: ob die Standardaktion des Ereignisses verhindert werden kann oder nicht. Setzt den Wert von Event.cancelable.
view: das AbstractView des Ereignisses. Sie sollten hier das window-Objekt übergeben. Setzt den Wert von UIEvent.view.
detail: die Klickanzahl des Ereignisses. Setzt den Wert von UIEvent.detail.
screenX: die Bildschirm-X-Koordinate des Ereignisses. Setzt den Wert von MouseEvent.screenX.
screenY: die Bildschirm-Y-Koordinate des Ereignisses. Setzt den Wert von MouseEvent.screenY.
clientX: die Client-X-Koordinate des Ereignisses. Setzt den Wert von MouseEvent.clientX.
clientY: die Client-Y-Koordinate des Ereignisses. Setzt den Wert von MouseEvent.clientY.
ctrlKey: ob die Steuerung-Taste während des Ereignisses gedrückt wurde oder nicht. Setzt den Wert von MouseEvent.ctrlKey.
altKey: ob die Alt-Taste während des Ereignisses gedrückt wurde oder nicht. Setzt den Wert von MouseEvent.altKey.
shiftKey: ob die Umschalt-Taste während des Ereignisses gedrückt wurde oder nicht. Setzt den Wert von MouseEvent.shiftKey.
metaKey: ob die Meta-Taste während des Ereignisses gedrückt wurde oder nicht. Setzt den Wert von MouseEvent.metaKey.
button: das Maustasten-button des Ereignisses.
relatedTarget: das bezogene EventTarget des Ereignisses. Wird nur bei einigen Ereignistypen verwendet (z.B. mouseover und mouseout). In anderen Fällen übergeben Sie null.

Rückgabewert

Keiner (undefined).

Beispiele

const event = document.createEvent("MouseEvents");
event.initMouseEvent(
  "click",
  true,
  true,
  window,
  0,
  0,
  0,
  80,
  20,
  false,
  false,
  false,
  false,
  0,
  null,
);
document.body.dispatchEvent(event);

Spezifikationen

Specification
UI Events # dom-mouseevent-initmouseevent

Browser-Kompatibilität

Siehe auch

MouseEvent()-Konstruktor, die moderne Standardmethode zur Erstellung eines MouseEvent
Event.initEvent() ist eine einfachere Methode mit ähnlichem Zweck. Sie ist ebenfalls veraltet und sollte nicht mehr verwendet werden.