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.
addEventListener("pointercancel", (event) => {});
onpointercancel = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
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
bis1
, wobei0
und1
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
bis1
, wobei0
die Neutralstellung der Steuerung darstellt. PointerEvent.tiltX
Nur lesbar-
Der Ebenenwinkel (in Grad, im Bereich von
-90
bis90
) 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
bis90
) 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
bis359
. 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()
:
const para = document.querySelector("p");
para.addEventListener("pointercancel", (event) => {
console.log("Pointer event cancelled");
});
Verwendung der onpointercancel
Ereignishandler-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
BCD tables only load in the browser