Element: touchcancel-Ereignis
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das touchcancel-Ereignis wird ausgelöst, wenn ein oder mehrere Berührungspunkte auf eine implementationsspezifische Weise unterbrochen wurden.
Einige Beispiele für Situationen, die ein touchcancel-Ereignis auslösen:
- Ein Hardware-Ereignis tritt auf, das die Berührungsaktivitäten abbricht. Dazu kann beispielsweise gehören, dass der Benutzer mit einer Anwendungsumschaltoberfläche oder der "Home"-Taste auf einem mobilen Gerät Anwendungen wechselt.
- Die Ausrichtung des Gerätebildschirms wird geändert, während die Berührung aktiv ist.
- Der Browser entscheidet, dass der Benutzer die Berührungseingabe versehentlich gestartet hat. Dies kann passieren, wenn die Hardware beispielsweise Palm-Rejection unterstützt, um zu verhindern, dass eine Hand, die auf dem Display ruht, beim Verwenden eines Stylus versehentlich Ereignisse auslöst.
- Die
touch-actionCSS-Eigenschaft verhindert, dass die Eingabe fortgesetzt wird. - Wenn der Benutzer mit zu vielen Fingern gleichzeitig interagiert, kann der Browser dieses Ereignis für alle bestehenden Zeiger auslösen (auch wenn der Benutzer den Bildschirm noch berührt).
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("touchcancel", (event) => { })
ontouchcancel = (event) => { }
Ereignistyp
Ein TouchEvent. Erbt von Event.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von ihrem Elternteil, UIEvent und Event.
TouchEvent.altKeySchreibgeschützt-
Ein Boolean-Wert, der angibt, ob die Alt-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.changedTouchesSchreibgeschützt-
Eine
TouchListallerTouch-Objekte, die einzelne Berührungspunkte repräsentieren, deren Zustand sich zwischen dem vorherigen und diesem Berührungsereignis geändert hat. TouchEvent.ctrlKeySchreibgeschützt-
Ein Boolean-Wert, der angibt, ob die Steuerungstaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.metaKeySchreibgeschützt-
Ein Boolean-Wert, der angibt, ob die Meta-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.shiftKeySchreibgeschützt-
Ein Boolean-Wert, der angibt, ob die Umschalttaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.targetTouchesSchreibgeschützt-
Eine
TouchListallerTouch-Objekte, die sich derzeit sowohl in Kontakt mit der Berührungsfläche befinden als auch auf demselben Element gestartet wurden, das das Ziel des Ereignisses ist. TouchEvent.touchesSchreibgeschützt-
Eine
TouchListallerTouch-Objekte, die alle aktuellen Berührungspunkte mit der Oberfläche darstellen, unabhängig von Ziel oder geändertem Status. TouchEvent.rotationNicht standardisiert Schreibgeschützt-
Veränderung der Rotation (in Grad) seit Beginn des Ereignisses. Positive Werte zeigen eine Drehung im Uhrzeigersinn an; negative Werte zeigen eine Drehung gegen den Uhrzeigersinn an. Ausgangswert:
0.0. TouchEvent.scaleNicht standardisiert Schreibgeschützt-
Abstand zwischen zwei Punkten seit Beginn des Ereignisses. Ausgedrückt als Gleitkommamultiplikator des anfänglichen Abstands zwischen den Punkten zu Beginn des Ereignisses. Werte unter 1.0 zeigen ein Verkleinern (Herauszoomen) an. Werte über 1.0 zeigen ein Vergrößern (Hineinzoomen) an. Ausgangswert:
1.0.
Beispiele
Beispielcode für diese Ereignisse ist auf der speziellen Seite verfügbar: Touch events.
Spezifikationen
| Specification |
|---|
| Touch Events # event-touchcancel |
| Touch Events # dom-globaleventhandlers-ontouchcancel |
Browser-Kompatibilität
Loading…