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. Er ist case-sensitive und Browser setzen ihn 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, die standardmäßig auf 0 gesetzt ist und die horizontale Position des Mausereignisses auf dem Bildschirm des Benutzers darstellt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

screenY Optional

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

clientX Optional

Eine Zahl, die standardmäßig auf 0 gesetzt ist und die horizontale Position des Mausereignisses im clientseitigen Fenster des Benutzers darstellt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

clientY Optional

Eine Zahl, die standardmäßig auf 0 gesetzt ist und die vertikale Position des Mausereignisses im clientseitigen Fenster des Benutzers darstellt; das Setzen dieses Wertes bewegt den Mauszeiger nicht.

ctrlKey Optional

Ein boolescher Wert, der anzeigt, ob die ctrl-Taste gleichzeitig gedrückt wurde. Der Standardwert ist false.

shiftKey Optional

Ein boolescher Wert, der anzeigt, ob die shift-Taste gleichzeitig gedrückt wurde. Der Standardwert ist false.

altKey Optional

Ein boolescher Wert, der anzeigt, ob die alt-Taste gleichzeitig gedrückt wurde. Der Standardwert ist false.

metaKey Optional

Ein boolescher Wert, der anzeigt, ob die meta-Taste gleichzeitig gedrückt wurde. Der Standardwert ist false.

button Optional

Eine Zahl, die standardmäßig auf 0 gesetzt ist und beschreibt, welche Taste während der Ereignisse im Zusammenhang mit dem Drücken oder Loslassen einer Taste gedrückt wird:

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

Eine Zahl, die standardmäßig auf 0 gesetzt ist und beschreibt, welche Tasten gedrückt sind, wenn das Ereignis ausgelöst wird:

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

Ein EventTarget, standardmäßig auf null gesetzt, das das gerade verlassene Element ist (im Fall von mouseenter oder mouseover) oder das betretene Element (im Fall von mouseout oder mouseleave).

region Nicht standardisiert Optional

Ein String, der standardmäßig auf null gesetzt ist und die ID des von dem Ereignis betroffenen Hit-Region darstellt. Das Fehlen einer betroffenen Hit-Region wird durch den null Wert dargestellt.

In einigen Implementierungen wird das Übergeben von Werten, die keine Zahl sind, für die Felder screen und client ein TypeError auslösen.

Spezifikationen

Specification
UI Events
# dom-mouseevent-mouseevent

Browser-Kompatibilität

Siehe auch

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