Element: pointerrawupdate Ereignis
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das pointerrawupdate
-PointerEvent
wird ausgelöst, wenn ein Zeiger Eigenschaften ändert, die nicht durch pointerdown
oder pointerup
Ereignisse ausgelöst werden.
Siehe pointermove
für eine Liste dieser Eigenschaften.
Das pointerrawupdate
-Ereignis kann zusammengefasste Ereignisse enthalten, wenn bereits ein anderes pointerrawupdate
-Ereignis mit derselben Zeiger-ID im Ereigniszyklus vorliegt, das noch nicht abgewickelt wurde.
Für Informationen über zusammengefasste Ereignisse lesen Sie die Dokumentation zu PointerEvent.getCoalescedEvents
.
Listener für pointerrawupdate
-Ereignisse sollten nur hinzugefügt werden, wenn Ihr JavaScript hochfrequente Ereignisse benötigt und diese so schnell wie möglich verarbeitet werden können, sobald sie abgewickelt werden.
Für die meisten Anwendungsfälle sollten andere Zeiger-Ereignistypen ausreichen, da es zu Leistungseinbußen kommen kann, wenn Listener für pointerrawupdate
-Ereignisse hinzugefügt werden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("pointerrawupdate", (event) => {});
onpointerrawupdate = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Nur lesbar Experimentell-
Repräsentiert den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräteschirms.
PointerEvent.azimuthAngle
Nur lesbar Experimentell-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Transducer-Achse (ein Zeiger oder Stift) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId
Nur lesbar Experimentell-
Eine eindeutige Kennung für das Eingabegerät, das das
PointerEvent
erzeugt. PointerEvent.pointerId
Nur lesbar-
Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width
Nur lesbar-
Die Breite (Magnitude auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height
Nur lesbar-
Die Höhe (Magnitude auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Nur lesbar-
Der normalisierte Druck des Zeiger-Eingabegeräts im Bereich von
0
bis1
, wobei0
und1
den minimalen bzw. maximalen Druck darstellen, den die Hardware erkennen kann. PointerEvent.tangentialPressure
Nur lesbar-
Der normalisierte tangentiale Druck des Zeiger-Eingabegeräts (auch als Barrel-Druck oder Zylinderbelastung bekannt) im Bereich von
-1
bis1
, wobei0
die neutrale Position der Steuerung ist. PointerEvent.tiltX
Nur lesbar-
Der Ebenenwinkel (in Grad, im Bereich von
-90
bis90
) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Stift-Stylus) als auch die Y-Achse enthält. PointerEvent.tiltY
Nur lesbar-
Der Ebenenwinkel (in Grad, im Bereich von
-90
bis90
) zwischen der X–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Stift-Stylus) als auch die X-Achse enthält. PointerEvent.twist
Nur lesbar-
Die Drehung des Zeigers (z. B. Stift-Stylus) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Nur lesbar-
Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung usw.).
PointerEvent.isPrimary
Nur lesbar-
Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.
Beispiel
addEventListener("pointerrawupdate", (event) => {
if (event.getCoalescedEvents && event.getCoalescedEvents().length > 1) {
console.log("Coalesced events:", event.getCoalescedEvents().length);
for (let coalescedEvent of event.getCoalescedEvents()) {
// Do something with the coalesced events.
}
} else {
// Do something with the event.
console.log("Raw event", event);
}
});
Spezifikationen
Specification |
---|
Pointer Events # the-pointerrawupdate-event |
Pointer Events # dom-globaleventhandlers-onpointerrawupdate |
Browser-Kompatibilität
BCD tables only load in the browser