Element: pointercancel Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Das pointercancel Ereignis wird ausgelöst, wenn der Browser feststellt, dass wahrscheinlich keine weiteren Pointer-Ereignisse mehr auftreten werden, oder wenn nach dem pointerdown Ereignis der Pointer dann verwendet wird, um den Viewport durch Schwenken, Zoomen oder Scrollen zu manipulieren.

Einige Beispiele für Situationen, die ein pointercancel Ereignis auslösen:

  • Ein Hardwareereignis tritt auf, das die Zeigeraktivitäten abbricht. Dies kann zum Beispiel der Fall sein, wenn der Benutzer mit einer Anwendungsswitcher-Oberfläche die Anwendung wechselt oder auf einem mobilen Gerät die "Home"-Taste drückt.
  • Die Bildschirmorientierung des Geräts wird geändert, während der Zeiger aktiv ist.
  • Der Browser entscheidet, dass der Benutzer versehentlich die Pointer-Eingabe gestartet hat. Dies kann passieren, wenn die Hardware z.B. Palm Rejection unterstützt, um zu verhindern, dass eine auf dem Bildschirm ruhende Hand bei der Verwendung eines Stylus versehentlich Ereignisse auslöst.
  • Die CSS-Eigenschaft touch-action verhindert das Fortsetzen der Eingabe.
  • Wenn der Benutzer mit zu vielen gleichzeitigen Zeigern interagiert, kann der Browser dieses Ereignis für alle vorhandenen Zeiger auslösen (selbst wenn der Benutzer den Bildschirm noch berührt).

Hinweis: Nachdem das pointercancel Ereignis ausgelöst wurde, sendet der Browser auch pointerout, gefolgt von pointerleave.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("pointercancel", (event) => {});

onpointercancel = (event) => {};

Ereignistyp

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 Stylus) und der X-Y-Ebene eines Geräts.

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 Stylus) als auch die Y-Achse enthält.

PointerEvent.persistentDeviceId Nur lesbar Experimentell

Eine eindeutige Kennung für das Zeigegerä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-Pixel, der Kontaktgeometrie des Zeigers.

PointerEvent.height Nur lesbar

Die Höhe (Magnitude auf der Y-Achse), in CSS-Pixel, der Kontaktgeometrie des Zeigers.

PointerEvent.pressure Nur lesbar

Der normalisierte Druck der Zeigereingabe im Bereich von 0 bis 1, wobei 0 und 1 den minimal- und maximalen Druck darstellen, den die Hardware erkennen kann.

PointerEvent.tangentialPressure Nur lesbar

Der normalisierte tangentiale Druck der Zeigereingabe (auch als Zylinderspannung bekannt) im Bereich von -1 bis 1, wobei 0 die Neutralstellung der Steuerung darstellt.

PointerEvent.tiltX Nur lesbar

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. ein Stylus) als auch die Y-Achse enthält.

PointerEvent.tiltY Nur lesbar

Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. ein Stylus) als auch die X-Achse enthält.

PointerEvent.twist Nur lesbar

Die Drehung im Uhrzeigersinn des Zeigers (z.B. eines Stylus) um seine Hauptachse in Grad, mit einem Wert im Bereich 0 bis 359.

PointerEvent.pointerType Nur lesbar

Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung, etc.).

PointerEvent.isPrimary Nur lesbar

Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Verwendung von addEventListener():

js
const para = document.querySelector("p");

para.addEventListener("pointercancel", (event) => {
  console.log("Pointer event cancelled");
});

Verwendung der onpointercancel Ereignishandler-Eigenschaft:

js
const para = document.querySelector("p");

para.onpointercancel = (event) => {
  console.log("Pointer event cancelled");
};

Spezifikationen

Specification
Pointer Events
# the-pointercancel-event
Pointer Events
# dom-globaleventhandlers-onpointercancel

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch