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.
addEventListener("pointermove", (event) => {});
onpointermove = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
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
bis1
, wobei0
und1
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
bis1
, wobei0
die neutrale Position der Kontrolle ist. PointerEvent.tiltX
Schreibgeschützt-
Der Ebenenwinkel (in Grad, im Bereich von
-90
bis90
) 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
bis90
) 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
bis359
. 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:
const para = document.querySelector("p");
para.addEventListener("pointermove", (event) => {
console.log("Pointer moved");
});
Sie können auch die onpointermove
Ereignishandlereigenschaft verwenden:
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