MouseEvent: MouseEvent() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der MouseEvent() Konstruktor erstellt ein neues MouseEvent-Objekt.

Syntax

js
new MouseEvent(type)
new MouseEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Es ist groß-/klein-schreibungssensitiv und Browser setzen es auf click, dblclick, mousedown, mouseenter, mouseleave, mousemove, mouseout, mouseover oder mouseup.

options Optional

Ein Objekt, das zusätzlich zu den in UIEvent() definierten Eigenschaften die folgenden Eigenschaften haben kann:

screenX Optional

Eine Zahl, standardmäßig 0, die die horizontale Position des Mausereignisses auf dem Bildschirm des Benutzers angibt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

screenY Optional

Eine Zahl, standardmäßig 0, die die vertikale Position des Mausereignisses auf dem Bildschirm des Benutzers angibt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

clientX Optional

Eine Zahl, standardmäßig 0, die die horizontale Position des Mausereignisses im Clientfenster auf dem Bildschirm des Benutzers angibt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

clientY Optional

Eine Zahl, standardmäßig 0, die die vertikale Position des Mausereignisses im Clientfenster auf dem Bildschirm des Benutzers angibt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

ctrlKey Optional

Ein boolescher Wert, der angibt, ob die ctrl-Taste gleichzeitig gedrückt wurde. Standardmäßig false.

shiftKey Optional

Ein boolescher Wert, der angibt, ob die shift-Taste gleichzeitig gedrückt wurde. Standardmäßig false.

altKey Optional

Ein boolescher Wert, der angibt, ob die alt-Taste gleichzeitig gedrückt wurde. Standardmäßig false.

metaKey Optional

Ein boolescher Wert, der angibt, ob die meta-Taste gleichzeitig gedrückt wurde. Standardmäßig false.

button Optional

Eine Zahl, standardmäßig 0, die beschreibt, welcher Knopf bei Ereignissen im Zusammenhang mit dem Drücken oder Loslassen eines Knopfes gedrückt wird:

Wert Bedeutung
0 Haupttaste gedrückt (normalerweise die linke Taste) oder nicht initialisiert
1 Hilfstaste gedrückt (normalerweise die mittlere Taste)
2 Sekundärtaste gedrückt (normalerweise die rechte Taste)
buttons Optional

Eine Zahl, standardmäßig 0, die beschreibt, welche Tasten beim Auslösen des Ereignisses gedrückt sind:

Bit-Feld-Wert Bedeutung
0 Keine Taste gedrückt
1 Haupttaste gedrückt (normalerweise die linke Taste)
2 Sekundärtaste gedrückt (normalerweise die rechte Taste)
4 Hilfstaste gedrückt (normalerweise die mittlere Taste)
relatedTarget Optional

Ein EventTarget, standardmäßig null, das das gerade verlassene Element ist (im Fall eines mouseenter oder mouseover) oder in das eingetreten wird (im Fall eines mouseout oder mouseleave).

region Nicht standardisiert Optional

Ein String, standardmäßig null, der die ID der vom Ereignis betroffenen Hit-Region ist. Das Fehlen einer betroffenen Hit-Region wird durch den Wert null dargestellt.

In einigen Implementierungen wird ein TypeError geworfen, wenn etwas anderes als eine Zahl für die screen- und client-Felder übergeben wird.

Spezifikationen

Specification
UI Events
# dom-mouseevent-mouseevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • MouseEvent, die Schnittstelle der Objekte, die sie konstruiert.