Element: pointercancel Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
Das pointercancel-Ereignis wird ausgelöst, wenn der Browser feststellt, dass es wahrscheinlich keine weiteren Pointer-Ereignisse geben wird, oder wenn nach dem pointerdown-Ereignis 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 geschehen, wenn der Benutzer Anwendungen über ein Anwendungsumschalter-Interface wechselt oder die "Home"-Taste auf einem mobilen Gerät drückt.
- Die Ausrichtung des Gerätebildschirms wird geändert, während der Pointer aktiv ist.
- Der Browser entscheidet, dass der Benutzer versehentlich die Eingabe mit dem Pointer begonnen hat. Dies kann der Fall sein, wenn die Hardware Palm-Rejection unterstützt, um zu verhindern, dass eine auf dem Display ruhende Hand beim Verwenden eines Stifts versehentlich Ereignisse auslöst.
- Die
touch-actionCSS-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 (selbst wenn der Benutzer noch den Bildschirm 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.
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
| Spezifikation |
|---|
| Pointer Events # the-pointercancel-event |
| Pointer Events # dom-globaleventhandlers-onpointercancel |