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.

Der PointerEvent()-Konstruktor erstellt eine neue synthetische und nicht vertrauenswürdige PointerEvent-Objektinstanz.

Syntax

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

Parameter

type

Ein Zeichenfolgenwert, der den Namen des Ereignisses darstellt (siehe PointerEvent-Ereignistypen).

options Optional

Ein Objekt, das neben den in MouseEvent() definierten Eigenschaften die folgenden Eigenschaften aufweisen kann:

pointerId: Eine Zahl, standardmäßig 0, die den Wert der Instanz von PointerEvent.pointerId festlegt.
width: Eine Zahl, standardmäßig 1, die den Wert der Instanz von PointerEvent.width festlegt.
height: Eine Zahl, standardmäßig 1, die den Wert der Instanz von PointerEvent.height festlegt.
pressure: Eine Zahl, standardmäßig 0, die den Wert der Instanz von PointerEvent.pressure festlegt.
tangentialPressure: Eine Zahl, standardmäßig 0, die den Wert der Instanz von PointerEvent.tangentialPressure festlegt.
altitudeAngle: Eine Zahl, die den Wert der Instanz von PointerEvent.altitudeAngle festlegt.
azimuthAngle: Eine Zahl, die den Wert der Instanz von PointerEvent.azimuthAngle festlegt.
tiltX: Eine Zahl, die den Wert der Instanz von PointerEvent.tiltX festlegt.
tiltY: Eine Zahl, die den Wert der Instanz von PointerEvent.tiltY festlegt.
twist: Eine Zahl, standardmäßig 0, die den Wert der Instanz von PointerEvent.twist festlegt.
pointerType: Eine Zeichenfolge, standardmäßig "", die den Wert der Instanz von PointerEvent.pointerType festlegt.
isPrimary: Ein boolescher Wert, standardmäßig false, der den Wert der Instanz von 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

Browser-Kompatibilität

BCD tables only load in the browser