Element: pointerrawupdate Ereignis

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 eine seiner Eigenschaften ändert, die keine pointerdown oder pointerup Ereignisse auslösen. Siehe pointermove für eine Liste dieser Eigenschaften.

Das pointerrawupdate Ereignis kann gebündelte Ereignisse enthalten, wenn bereits ein anderes pointerrawupdate Ereignis mit derselben Zeiger-ID vorhanden ist, das noch nicht in der Ereignisschleife versendet wurde. Für Informationen zu gebündelten Ereignissen, siehe die Dokumentation zu PointerEvent.getCoalescedEvents().

pointerrawupdate ist für Anwendungen gedacht, die eine hochpräzise Eingabeverarbeitung erfordern und keine flüssige Interaktion allein durch gebündelte pointermove Ereignisse erreichen können. Da das Listening auf pointerrawupdate Ereignisse jedoch die Leistung beeinträchtigen kann, sollten Sie diese Listener nur hinzufügen, wenn Ihr JavaScript hochfrequente Ereignisse benötigt und diese so schnell verarbeiten kann, wie sie versendet werden. Für die meisten Anwendungsfälle sollten andere Zeigerereignistypen ausreichen.

Dieses Ereignis blubbert und ist komponiert, aber es ist nicht stornierbar 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

Dieses Interface erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen einer Achse eines Transducers (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräts dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Achse des Transducers (einem Zeiger oder Stylus) als auch die Y-Achse enthält.
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 ausgelöst hat.
PointerEvent.width Schreibgeschützt: Die Breite (Magnitude auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Magnitude auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
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 als Barrel-Druck oder Zylinderstress bekannt) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Winkel der Ebene (in Grad, im Bereich von -90 bis 90) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stiftes) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Winkel der Ebene (in Grad, im Bereich von -90 bis 90) zwischen der X–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. eines Stiftes) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z.B. eines Stiftes) um seine Hauptachse 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 etc.).
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

Siehe auch

Verwandte Ereignisse