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 Zeigerereignisse mehr auftreten, oder wenn nach dem Auslösen des pointerdown-Ereignisses der Zeiger zur Manipulation des Ansichtsfensters durch Schwenken, Zoomen oder Scrollen verwendet wird.

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

Ein Hardware-Ereignis tritt auf, das die Zeigeraktivitäten abbricht. Dies kann z. B. der Fall sein, wenn der Benutzer Anwendungen über eine Anwendungsschaltfläche oder die "Home"-Taste auf einem mobilen Gerät wechselt.
Die Bildschirmorientierung des Geräts wird geändert, während der Zeiger aktiv ist.
Der Browser entscheidet, dass der Benutzer die Zeigereingabe versehentlich gestartet hat. Dies kann passieren, wenn die Hardware z. B. Palm Rejection unterstützt, um zu verhindern, dass eine Hand, die beim Verwenden eines Stifts auf dem Display ruht, versehentlich Ereignisse auslöst.
Die touch-action CSS-Eigenschaft verhindert, dass die Eingabe fortgesetzt wird.
Wenn der Benutzer mit zu vielen gleichzeitigen Zeigern interagiert, kann der Browser dieses Ereignis für alle vorhandenen Zeiger auslösen (auch 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 Ereignis-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 (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräteschirms.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (einem Zeiger oder Stift) 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 (Ausdehnung auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Ausdehnung 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 jeweils den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung darstellt.
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 Stiftstifts) 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 Stiftstifts) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung des Zeigers im Uhrzeigersinn (z. B. eines Stiftstifts) 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 Ereignis-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