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.

js
addEventListener("touchcancel", (event) => { })

ontouchcancel = (event) => { }

Ereignistyp

Ein TouchEvent. Erbt von Event.

Event UIEvent TouchEvent

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 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 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