Element: pointercancel event

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 Auslösen des pointerdown-Ereignisses der Zeiger verwendet wird, um den Ansichtsbereich durch Schwenken, Zoomen oder Scrollen zu manipulieren.

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

Ein Hardwareereignis tritt auf, das die Pointer-Aktivitäten abbricht. Dies kann beispielsweise passieren, wenn der Benutzer mit einer Anwendungsumschaltoberfläche oder der „Home“-Taste auf einem mobilen Gerät Anwendungen wechselt.
Die Ausrichtung des Bildschirms des Geräts wird geändert, während der Zeiger aktiv ist.
Der Browser entscheidet, dass der Benutzer die Eingabe versehentlich begonnen hat. Dies kann passieren, wenn die Hardware Palm-Rejection unterstützt, um zu verhindern, dass eine Hand, die auf dem Bildschirm ruht, während eines Stylus verwendet wird, versehentlich Ereignisse auslöst.
Die CSS-Eigenschaft touch-action verhindert, dass die Eingabe fortgesetzt wird.
Wenn der Benutzer mit zu vielen gleichzeitigen Zeigern interagiert, kann der Browser dieses Ereignis für alle bestehenden Zeiger auslösen (auch wenn der Benutzer den Bildschirm noch berührt).

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

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignisbehandlungseigenschaft.

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

onpointercancel = (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 Transducer-Achse (einem Zeiger oder Stylus) und der X-Y-Ebene eines Gerätescreens dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transducer-Achse (einem Zeiger oder Stylus) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt Experimentell: Eine eindeutige Kennung für das Eingabegerä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 (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 Pointer-Eingabe 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 Pointer-Eingabe (auch bekannt als barrel pressure oder cylinder stress) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Pen-Stylus) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Pen-Stylus) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z. B. Pen-Stylus) 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.

Beispiele

Verwendung von addEventListener():

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

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

Verwendung der onpointercancel-Ereignisbehandlungseigenschaft:

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

Siehe auch

Verwandte Ereignisse