Element: pointermove Ereignis
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. Es ist dem mousemove
-Ereignis sehr ähnlich, bietet jedoch mehr Funktionen.
Diese Ereignisse treten unabhängig davon auf, ob Zeigertasten gedrückt sind oder nicht. Sie können mit einer sehr hohen Frequenz ausgelöst werden, abhängig davon, wie schnell der Benutzer den Zeiger bewegt, wie leistungsfähig die Maschine ist, welche anderen Aufgaben und Prozesse ausgeführt werden usw.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("pointermove", (event) => {});
onpointermove = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Eigenschaften des Ereignisses
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Achse eines Wandlers (einem Zeiger oder Stylus) und der X-Y-Ebene eines Gerätedisplays.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Wandlers (einem Zeiger oder Stylus) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId
Schreibgeschützt Experimentell-
Eine eindeutige Kennung für das Zeigegerät, das das
PointerEvent
generiert. PointerEvent.pointerId
Schreibgeschützt-
Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width
Schreibgeschützt-
Die Breite (Ausdehnung auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Ausdehnung auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Schreibgeschützt-
Der normalisierte Druck der Zeigereingabe 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 der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderstress) im Bereich von
-1
bis1
, wobei0
die neutrale Position der Steuerung darstellt. PointerEvent.tiltX
Schreibgeschützt-
Der Winkel der Ebene (in Grad, im Bereich von
-90
bis90
) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. einer Pen-Stylus) als auch die Y-Achse enthält. PointerEvent.tiltY
Schreibgeschützt-
Der Winkel der Ebene (in Grad, im Bereich von
-90
bis90
) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. einer Pen-Stylus) als auch die X-Achse enthält. PointerEvent.twist
Schreibgeschützt-
Die Drehung des Zeigers (z. B. eines Pen-Stylus) im Uhrzeigersinn 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, Pen, Touch usw.).
PointerEvent.isPrimary
Schreibgeschützt-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Nutzungshinweise
Das Ereignis vom Typ PointerEvent
liefert alle Informationen, die Sie über die Benutzerinteraktion mit dem Zeigegerät wissen müssen, einschließlich Position, Bewegungsentfernung, Tastenstatus und vieles mehr.
Beispiele
So fügen Sie mit addEventListener()
einen Handler für pointermove
-Ereignisse hinzu:
const para = document.querySelector("p");
para.addEventListener("pointermove", (event) => {
console.log("Pointer moved");
});
Sie können auch die onpointermove
Ereignis-Handler-Eigenschaft 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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
pointermove event |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Requires a vendor prefix or different name for use.
- Has more compatibility info.