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 Pointer verwendet wird, um den Ansichtsbereich durch Schwenken, Zoomen oder Scrollen zu manipulieren.

Einige Beispiele von Situationen, die ein pointercancel-Ereignis auslösen:

Ein Hardware-Ereignis tritt auf, das die Pointer-Aktivitäten abbricht. Dies kann zum Beispiel passieren, wenn der Benutzer Anwendungen über eine App-Wechsel-Oberfläche wechselt oder die "Home"-Taste auf einem mobilen Gerät drückt.
Die Bildschirmorientierung des Geräts wird geändert, während der Pointer aktiv ist.
Der Browser entscheidet, dass der Benutzer die Pointer-Eingabe versehentlich gestartet hat. Dies kann vorkommen, wenn die Hardware Palm-Rejection unterstützt, um zu vermeiden, dass eine Hand, die auf dem Display ruht, während der Verwendung eines Stylus versehentlich Ereignisse auslöst.
Die touch-action CSS-Eigenschaft verhindert, dass die Eingabe fortgesetzt wird.
Wenn der Benutzer zu viele gleichzeitige Pointer verwendet, kann der Browser dieses Ereignis für alle bestehenden Pointer auslösen (auch wenn der Benutzer immer noch den Bildschirm berührt).

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

Syntax

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

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: Repräsentiert den Winkel zwischen der Achse eines Transducers (eines Zeigers oder Stylus) und der X-Y-Ebene eines Gerätescreens.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (eines Zeigers 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 generiert.
PointerEvent.pointerId Schreibgeschützt: Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width Schreibgeschützt: Die Breite (Ausmaß auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Ausmaß 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 bzw. maximalen Druck darstellen, den die Hardware erkennen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Barrel-Druck oder Zylinder-Stress) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. eines Stylus) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X–Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. eines Stylus) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z.B. eines 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 usw.).
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-Event-Handler-Eigenschaft:

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