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 Zeigerereignisse mehr geben wird, oder wenn nach dem Auslösen des pointerdown-Ereignisses der Zeiger dann zur Manipulation des Ansichtsbereichs durch Schwenken, Zoomen oder Scrollen verwendet wird.
Einige Beispiele für Situationen, die ein pointercancel-Ereignis auslösen werden:
- Ein Hardware-Ereignis tritt auf, das die Zeigeraktivitäten abbricht. Dies kann zum Beispiel der Fall sein, wenn der Benutzer zwischen Anwendungen über eine Anwendungsumschalter-Schnittstelle oder die "Home"-Taste auf einem Mobilgerä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 beispielsweise Palm Rejection unterstützt, um zu verhindern, dass sich eine Hand auf dem Display ablegt, während ein Stift verwendet wird und versehentlich Ereignisse auslöst.
- Die CSS-Eigenschaft
touch-actionverhindert, 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 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 canceled");
});
Verwendung der onpointercancel-Ereignishandler-Eigenschaft:
const para = document.querySelector("p");
para.onpointercancel = (event) => {
console.log("Pointer event canceled");
};
Spezifikationen
| Spezifikation |
|---|
| Pointer Events # pointercancel |
| Pointer Events # dom-globaleventhandlers-onpointercancel |