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 nicht vertrauenswürdige PointerEvent Objektinstanz.

Syntax

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

Parameter

type

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

options Optional

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

pointerId

Eine Zahl, standardmäßig 0, die den Wert der Instanz PointerEvent.pointerId festlegt.

width

Eine Zahl, standardmäßig 1, die den Wert der Instanz PointerEvent.width festlegt.

height

Eine Zahl, standardmäßig 1, die den Wert der Instanz PointerEvent.height festlegt.

pressure

Eine Zahl, standardmäßig 0, die den Wert der Instanz PointerEvent.pressure festlegt.

tangentialPressure

Eine Zahl, standardmäßig 0, die 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, standardmäßig 0, die den Wert der Instanz PointerEvent.twist festlegt.

pointerType

Ein String, standardmäßig "", der den Wert der Instanz PointerEvent.pointerType festlegt.

isPrimary

Ein boolescher Wert, standardmäßig false, der den Wert der Instanz PointerEvent.isPrimary festlegt.

Rückgabewert

Ein neues PointerEvent Objekt.

Beispiele

js
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