Element: pointerrawupdate Event
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Das pointerrawupdate
-Ereignis wird ausgelöst, wenn ein Zeiger Eigenschaften ändert, die keine pointerdown
- oder pointerup
-Ereignisse auslösen. Siehe pointermove
für eine Liste dieser Eigenschaften.
Das pointerrawupdate
-Ereignis kann zusammengeführte Ereignisse haben, wenn bereits ein anderes pointerrawupdate
-Ereignis mit derselben Zeiger-ID existiert, das noch nicht in der Ereignisschleife ausgelöst wurde. Weitere Informationen zu zusammengeführten Ereignissen finden Sie in der Dokumentation zu PointerEvent.getCoalescedEvents()
.
pointerrawupdate
ist für Anwendungen gedacht, die eine hochpräzise Eingabeverarbeitung erfordern und keine reibungslose Interaktion nur mit zusammengeführten pointermove
-Ereignissen erreichen können. Da jedoch das Abhören von pointerrawupdate
-Ereignissen die Leistung beeinträchtigen kann, sollten Sie diese Listener nur hinzufügen, wenn Ihr JavaScript hochfrequente Ereignisse benötigt und sie so schnell wie sie ausgelöst werden verarbeiten kann. Für die meisten Anwendungsfälle sollten andere Zeigerereignistypen ausreichen.
Dieses Ereignis bubbelt und ist zusammengesetzt, ist jedoch nicht abbrechbar und hat keine Standardaktion.
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
Schreibgeschützt Experimentell-
Stellt den Winkel zwischen einer Übertragungseinheit (einem Zeiger oder Stift) Achse und der X-Y-Ebene eines Gerätebildschirms dar.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Übertragungseinheit (einen Zeiger oder Stift) Achse als auch die Y-Achse enthält, dar.
PointerEvent.persistentDeviceId
Schreibgeschützt Experimentell-
Eine eindeutige Kennung für das Zeigegerä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 (Größe auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Größe 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 Flächenwinkel (in Grad, im Bereich von
-90
bis90
) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stiftstiftes) als auch die Y-Achse enthält. PointerEvent.tiltY
Schreibgeschützt-
Der Flächenwinkel (in Grad, im Bereich von
-90
bis90
) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stiftstiftes) als auch die X-Achse enthält. PointerEvent.twist
Schreibgeschützt-
Die Drehung des Zeigers (z.B. eines Stiftstiftes) um seine Hauptachse im Uhrzeigersinn 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.
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
Loading…