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 Juli 2020.
Das pointermove-Ereignis wird ausgelöst, wenn ein Zeiger die Koordinaten ändert und der Zeiger nicht durch eine touch-action des Browsers abgebrochen wurde. Es ist dem mousemove-Ereignis sehr ähnlich, jedoch mit mehr Funktionen.
Diese Ereignisse treten auf, unabhängig davon, ob Zeigertasten gedrückt sind oder nicht. Sie können mit hoher Frequenz auftreten, abhängig davon, wie schnell der Benutzer den Zeiger bewegt, wie schnell die Maschine ist, welche anderen Aufgaben und Prozesse ablaufen, usw.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("pointermove", (event) => { })
onpointermove = (event) => { }
Ereignistyp
Ein PointerEvent. Erbt von Event.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.
PointerEvent.altitudeAngleSchreibgeschützt Experimentell-
Stellt den Winkel zwischen der Achse eines Wandlers (eines Zeigers oder Stylus) und der X-Y-Ebene eines Gerätescreens dar.
PointerEvent.azimuthAngleSchreibgeschützt Experimentell-
Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Achse des Wandlers (eines Zeigers oder Stylus) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceIdSchreibgeschützt Experimentell-
Ein eindeutiger Bezeichner für das Zeigegerät, das das
PointerEventerzeugt. PointerEvent.pointerIdSchreibgeschützt-
Ein eindeutiger Bezeichner für den Zeiger, der das Ereignis verursacht.
PointerEvent.widthSchreibgeschützt-
Die Breite (Magnitude auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.heightSchreibgeschützt-
Die Höhe (Magnitude auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressureSchreibgeschützt-
Der normalisierte Druck der Zeigereingabe im Bereich von
0bis1, wobei0und1den minimalen bzw. maximalen Druck darstellen, den die Hardware erkennen kann. PointerEvent.tangentialPressureSchreibgeschützt-
Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Barrel-Druck oder Zylinderbelastung) im Bereich von
-1bis1, wobei0die neutrale Position der Steuerung ist. PointerEvent.tiltXSchreibgeschützt-
Der Ebenenwinkel (in Grad, im Bereich von
-90bis90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Stylus) als auch die Y-Achse enthält. PointerEvent.tiltYSchreibgeschützt-
Der Ebenenwinkel (in Grad, im Bereich von
-90bis90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Stylus) als auch die X-Achse enthält. PointerEvent.twistSchreibgeschützt-
Die Drehung des Zeigers (z.B. Stylus) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von
0bis359. PointerEvent.pointerTypeSchreibgeschützt-
Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Touch, etc.).
PointerEvent.isPrimarySchreibgeschützt-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Nutzungshinweise
Das Ereignis, das vom Typ PointerEvent ist, liefert alle Informationen, die Sie über die Interaktion des Benutzers mit dem Zeigegerät wissen müssen, einschließlich der Position, der Bewegungsdistanz, der Tastenstatus und vielem 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-Ereignishandler-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
Loading…