Element: pointerrawupdate-Ereignis
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 Pointer Eigenschaften ändert, die keine pointerdown oder pointerup Ereignisse auslösen. Eine Liste dieser Eigenschaften finden Sie unter pointermove.
Das pointerrawupdate-Ereignis kann zusammengefasste Ereignisse enthalten, wenn bereits ein anderes pointerrawupdate-Ereignis mit derselben Pointer-ID existiert, das in der Ereignisschleife noch nicht ausgelöst wurde. Wenn Ereignisse zusammengefasst werden, ist das target des ausgelösten Ereignisses dasselbe wie das letzte zusammengefasste. Informationen zu zusammengefassten Ereignissen finden Sie in der Dokumentation zu PointerEvent.getCoalescedEvents().
Der Unterschied zwischen pointerrawupdate und pointermove liegt in der Häufigkeit ihrer Auslösung. Ein Browser kann pointermove-Ereignisse verzögern, um die Leistung zu verbessern, während pointerrawupdate-Ereignisse so schnell und oft wie möglich von dem Browser bereitgestellt werden. Beide Ereignistypen werden zusammengefasst, aber pointerrawupdate wird weniger zusammengefasst, sodass seine Listener häufiger ausgeführt werden. Jedes einzelne Ereignis trägt dieselben Eigenschaftswerte, so dass pointerrawupdate nicht präziser in Raum oder Zeit ist als das pointermove-Ereignis, das dieselbe Bewegung abdeckt.
Daher ist pointerrawupdate für Anwendungen gedacht, die eine geringere Latenzzeit bei der Verarbeitung von Eingaben benötigen, als pointermove bietet, wie z.B. beim Zeichnen oder Ziehen, das sonst sichtbar hinter dem Zeiger hinterherhinken würde. Da die Ereignisse häufiger eintreffen, kann sich eine Anwendung, die damit Schritt hält, auch flüssiger anfühlen. Da das Lauschen auf pointerrawupdate-Ereignisse jedoch die Leistung beeinflussen kann, sollten Sie diese Listener nur hinzufügen, wenn Ihr JavaScript hochfrequente Ereignisse benötigt und diese so schnell wie sie ausgelöst werden verarbeiten kann. Eine Anwendung, die nicht Schritt halten kann, fühlt sich weniger reaktionsschnell an, anstatt mehr, daher ist eine intensive Optimierung innerhalb des Ereignis-Listeners erforderlich. Für die meisten Anwendungsfälle sollten andere Pointer-Ereignistypen ausreichen.
Dieses Ereignis blubbert und ist komponiert, aber es ist nicht abbrechbar und hat keine Standardaktion.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("pointerrawupdate", (event) => { })
onpointerrawupdate = (event) => { }
Ereignistyp
Ein PointerEvent. Erbt von Event.
Beispiel
canvas.addEventListener("pointerrawupdate", (event) => {
const events = event.getCoalescedEvents();
if (events.length > 1) {
console.log("Coalesced events:", events.length);
for (const coalescedEvent of events) {
// Do something with the coalesced events.
}
} else {
// Do something with the event.
console.log("Raw event", event);
}
});
Spezifikationen
| Spezifikation |
|---|
| Pointer Events # pointerrawupdate |
| Pointer Events # dom-globaleventhandlers-onpointerrawupdate |