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-action CSS-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.altKey Schreibgeschützt: Ein Boolean-Wert, der angibt, ob die Alt-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.changedTouches Schreibgeschützt: Eine TouchList aller Touch-Objekte, die einzelne Berührungspunkte repräsentieren, deren Zustand sich zwischen dem vorherigen und diesem Berührungsereignis geändert hat.
TouchEvent.ctrlKey Schreibgeschützt: Ein Boolean-Wert, der angibt, ob die Steuerungstaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.metaKey Schreibgeschützt: Ein Boolean-Wert, der angibt, ob die Meta-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.shiftKey Schreibgeschützt: Ein Boolean-Wert, der angibt, ob die Umschalttaste gedrückt war, als das Berührungsereignis ausgelöst wurde.
TouchEvent.targetTouches Schreibgeschützt: Eine TouchList aller Touch-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.touches Schreibgeschützt: Eine TouchList aller Touch-Objekte, die alle aktuellen Berührungspunkte mit der Oberfläche darstellen, unabhängig von Ziel oder geändertem Status.
TouchEvent.rotation Nicht 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.scale Nicht 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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden