Element: pointermove Event

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.

Das pointermove-Ereignis wird ausgelöst, wenn ein Zeiger seine Koordinaten ändert und der Zeiger nicht durch eine Browser-touch-action abgebrochen wurde.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandlereigenschaft.

js
addEventListener("pointermove", (event) => {});

onpointermove = (event) => {};

Ereignistyp

Ereigniseigenschaften

Dieses Interface erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell

Repräsentiert den Winkel zwischen einer Achse eines Transducers (einer Zeigereingabe oder eines Stifts) und der X-Y-Ebene eines Geräteschirms.

PointerEvent.azimuthAngle Schreibgeschützt Experimentell

Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (einer Zeigereingabe oder eines Stifts) als auch die Y-Achse enthält.

PointerEvent.persistentDeviceId Schreibgeschützt Experimentell

Eine eindeutige Kennung für das Eingabegerät, das das PointerEvent erzeugt.

PointerEvent.pointerId Schreibgeschützt

Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.

PointerEvent.width Schreibgeschützt

Die Breite (Magnitude auf der X-Achse) in CSS-Pixeln, der Kontaktgeometrie des Zeigers.

PointerEvent.height Schreibgeschützt

Die Höhe (Magnitude auf der Y-Achse) in CSS-Pixeln, der Kontaktgeometrie des Zeigers.

PointerEvent.pressure Schreibgeschützt

Der normalisierte Druck des Zeigereingangs im Bereich von 0 bis 1, wobei 0 und 1 den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann.

PointerEvent.tangentialPressure Schreibgeschützt

Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Barreldruck oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Kontrolle ist.

PointerEvent.tiltX Schreibgeschützt

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z. B. eines Stiftzeichners) als auch die Y-Achse enthält.

PointerEvent.tiltY Schreibgeschützt

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z. B. eines Stiftzeichners) als auch die X-Achse enthält.

PointerEvent.twist Schreibgeschützt

Die Drehung im Uhrzeigersinn des Zeigers (z. B. eines Stiftzeichners) um seine Hauptachse in Grad, mit einem Wert im Bereich von 0 bis 359.

PointerEvent.pointerType Schreibgeschützt

Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung usw.).

PointerEvent.isPrimary Schreibgeschützt

Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Verwendungshinweise

Das Ereignis vom Typ PointerEvent bietet alle Informationen, die Sie über die Interaktion des Benutzers mit dem Zeigegerät wissen müssen, einschließlich Position, Bewegungsdistanz, Tastenstatus und vieles mehr.

Beispiele

Um einen Handler für pointermove-Ereignisse mit addEventListener() hinzuzufügen:

js
const para = document.querySelector("p");

para.addEventListener("pointermove", (event) => {
  console.log("Pointer moved");
});

Sie können auch die onpointermove Ereignishandlereigenschaft verwenden:

js
const para = document.querySelector("p");

para.onpointermove = (event) => {
  console.log("Pointer moved");
};

Spezifikationen

Specification
Pointer Events
# the-pointermove-event
Pointer Events
# dom-globaleventhandlers-onpointermove

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch