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 sich die Koordinaten eines Zeigers ändern 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 auf, unabhängig davon, ob Zeigertasten gedrückt sind oder nicht. Sie können mit sehr hoher Frequenz ausgelöst werden, abhängig davon, wie schnell der Benutzer den Zeiger bewegt, wie schnell die Maschine ist, welche anderen Aufgaben und Prozesse laufen 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.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Transducer-Achse (ein Zeiger oder Stylus) und der X-Y-Ebene eines Geräts.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Transducer-Achse (ein Zeiger oder Stylus) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt Experimentell: Ein einzigartiger Bezeichner für das Eingabegerät, das das PointerEvent erzeugt.
PointerEvent.pointerId Schreibgeschützt: Ein einzigartiger Bezeichner für den Zeiger, der das Ereignis verursacht.
PointerEvent.width Schreibgeschützt: Die Breite (Magnitude auf der X-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
PointerEvent.height Schreibgeschützt: Die Höhe (Magnitude auf der Y-Achse) der Kontaktgeometrie des Zeigers in CSS-Pixeln.
PointerEvent.pressure Schreibgeschützt: Der normalisierte Druck der Zeigereingabe 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 der Zeigereingabe (auch bekannt als Barrel Pressure oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Kontrolle ist.
PointerEvent.tiltX Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Pen Stylus) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Pen Stylus) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung des Zeigers (z.B. Pen Stylus) um seine Hauptachse im Uhrzeigersinn 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, welches vom Typ PointerEvent ist, liefert 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-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

Siehe auch

Verwandte Ereignisse