PointerEvent: PointerEvent() 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 2020.

* Some parts of this feature may have varying levels of support.

Der PointerEvent() Konstruktor erstellt eine neue synthetische und unzuverlässige PointerEvent-Objektinstanz.

Syntax

new PointerEvent(type)
new PointerEvent(type, options)

Parameter

type

Ein String, der den Namen des Ereignisses repräsentiert (siehe PointerEvent-Ereignistypen).

options Optional

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

pointerId: Eine Zahl, die standardmäßig 0 ist und den Wert der Instanz PointerEvent.pointerId festlegt.
width: Eine Zahl, die standardmäßig 1 ist und den Wert der Instanz PointerEvent.width festlegt.
height: Eine Zahl, die standardmäßig 1 ist und den Wert der Instanz PointerEvent.height festlegt.
pressure: Eine Zahl, die standardmäßig 0 ist und den Wert der Instanz PointerEvent.pressure festlegt.
tangentialPressure: Eine Zahl, die standardmäßig 0 ist und den Wert der Instanz PointerEvent.tangentialPressure festlegt.
altitudeAngle: Eine Zahl, die den Wert der Instanz PointerEvent.altitudeAngle festlegt.
azimuthAngle: Eine Zahl, die den Wert der Instanz PointerEvent.azimuthAngle festlegt.
tiltX: Eine Zahl, die den Wert der Instanz PointerEvent.tiltX festlegt.
tiltY: Eine Zahl, die den Wert der Instanz PointerEvent.tiltY festlegt.
twist: Eine Zahl, die standardmäßig 0 ist und den Wert der Instanz PointerEvent.twist festlegt.
pointerType: Ein String, der standardmäßig "" ist und den Wert der Instanz PointerEvent.pointerType festlegt.
isPrimary: Ein boolescher Wert, der standardmäßig false ist und den Wert der Instanz PointerEvent.isPrimary festlegt.

Rückgabewert

Ein neues PointerEvent-Objekt.

Beispiele

const moveEvent = new PointerEvent("pointermove");

const downEvent = new PointerEvent("pointerdown", {
  pointerId: 1,
  bubbles: true,
  cancelable: true,
  pointerType: "touch",
  width: 100,
  height: 100,
  isPrimary: true,
});

Spezifikationen

Specification
Pointer Events # dom-pointerevent-constructor