Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Element: touchcancel-Ereignis
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Dastouchcancel-Ereignis wird ausgelöst, wenn ein oder mehrere Berührungspunkte auf eine implementationsspezifische Weise unterbrochen wurden.
Einige Beispiele für Situationen, die eintouchcancel-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).
In diesem Artikel
Syntax
Verwenden Sie den Ereignisnamen in Methoden wieaddEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("touchcancel", (event) => { })ontouchcancel = (event) => { }Ereignistyp
EinTouchEvent. Erbt vonEvent.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von ihrem Elternteil,UIEvent undEvent.
TouchEvent.altKeySchreibgeschütztEin Boolean-Wert, der angibt, ob die Alt-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.changedTouchesSchreibgeschütztEine
TouchListallerTouch-Objekte, die einzelne Berührungspunkte repräsentieren, deren Zustand sich zwischen dem vorherigen und diesem Berührungsereignis geändert hat.TouchEvent.ctrlKeySchreibgeschütztEin Boolean-Wert, der angibt, ob die Steuerungstaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.metaKeySchreibgeschütztEin Boolean-Wert, der angibt, ob die Meta-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.shiftKeySchreibgeschütztEin Boolean-Wert, der angibt, ob die Umschalttaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.targetTouchesSchreibgeschütztEine
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ütztEine
TouchListallerTouch-Objekte, die alle aktuellen Berührungspunkte mit der Oberfläche darstellen, unabhängig von Ziel oder geändertem Status.TouchEvent.rotationNicht standardisiertSchreibgeschütztVerä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 standardisiertSchreibgeschütztAbstand 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> |