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 ein, das die Berührungsaktivitäten abbricht. Dazu gehört beispielsweise, dass der Benutzer Anwendungen über eine Anwendungsumschaltfläche wechselt oder die "Home"-Taste auf einem mobilen Gerät verwendet.
Die Bildschirmorientierung des Geräts wird geändert, während die Berührung aktiv ist.
Der Browser entscheidet, dass der Benutzer die Berührungseingabe versehentlich begonnen hat. Dies kann passieren, wenn die Hardware beispielsweise Palm-Rejection unterstützt, um zu verhindern, dass eine ruhende Hand auf dem Display beim Verwenden eines Stifts 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 weiterhin 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 boolescher Wert, der angibt, ob die Alt-Taste gedrückt war, als das Touch-Ereignis ausgelöst wurde.
TouchEvent.changedTouches Schreibgeschützt: Eine TouchList von allen Touch Objekten, die einzelne Kontaktpunkte darstellen, deren Zustände sich zwischen dem vorherigen Touch-Ereignis und diesem geändert haben.
TouchEvent.ctrlKey Schreibgeschützt: Ein boolescher Wert, der angibt, ob die Steuerungstaste gedrückt war, als das Touch-Ereignis ausgelöst wurde.
TouchEvent.metaKey Schreibgeschützt: Ein boolescher Wert, der angibt, ob die Meta-Taste gedrückt war, als das Touch-Ereignis ausgelöst wurde.
TouchEvent.shiftKey Schreibgeschützt: Ein boolescher Wert, der angibt, ob die Umschalttaste gedrückt war, als das Touch-Ereignis ausgelöst wurde.
TouchEvent.targetTouches Schreibgeschützt: Eine TouchList von allen Touch Objekten, die sich derzeit auf der Berührungsoberfläche befinden und auch auf demselben Element begonnen haben, das das Ziel des Ereignisses ist.
TouchEvent.touches Schreibgeschützt: Eine TouchList von allen Touch Objekten, die alle aktuellen Kontaktpunkte mit der Oberfläche darstellen, unabhängig vom Ziel oder geändertem Status.
TouchEvent.rotation Nicht standardisiert Schreibgeschützt: Änderung der Rotation (in Grad) seit Beginn des Ereignisses. Positive Werte weisen auf eine Drehung im Uhrzeigersinn hin; negative Werte geben eine Drehung gegen den Uhrzeigersinn an. Anfangswert: 0.0.
TouchEvent.scale Nicht standardisiert Schreibgeschützt: Abstand zwischen zwei Punkten seit Beginn des Ereignisses. Angegeben als Gleitkomma-Multiplikator des Anfangsabstands zwischen den Punkten zu Beginn des Ereignisses. Werte unter 1.0 deuten auf ein Hineinzwicken (Zoom out) hin. Werte über 1.0 deuten auf ein Herauszwicken (Zoom in) hin. Anfangswert: 1.0.

Beispiele

Codebeispiele für diese Ereignisse sind 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