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 implementierungsspezifische Weise unterbrochen wurden.

Einige Beispiele für Situationen, die ein touchcancel-Ereignis auslösen können:

  • Ein Hardware-Ereignis tritt auf, das die Berührungsaktivitäten abbricht. Dies kann beispielsweise der Fall sein, wenn der Benutzer Anwendungen mit einer Anwendungswechsler-Schnittstelle oder der "Home"-Taste auf einem mobilen Gerät wechselt.
  • Die Ausrichtung des Bildschirms des Geräts 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 Handflächenablehnung unterstützt, um zu verhindern, dass eine auf dem Bildschirm ruhende Hand beim Verwenden eines Stifts versehentlich Ereignisse auslöst.
  • Die CSS-Eigenschaft touch-action verhindert, dass die Eingabe fortgesetzt wird.
  • Wenn der Benutzer mit zu vielen Fingern gleichzeitig interagiert, kann der Browser dieses Ereignis für alle vorhandenen Zeigegeräte auslösen (auch wenn der Benutzer den Bildschirm noch berührt).

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandlereigenschaft.

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

ontouchcancel = (event) => {};

Ereignistyp

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 Status sich zwischen dem vorherigen Berührungsereignis und diesem 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 Metataste 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 sowohl derzeit in Kontakt mit der Berührungsoberflä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 vom Ziel oder dem geänderten Status.

TouchEvent.rotation Nicht standardisiert Schreibgeschützt

Änderung der Rotation (in Grad) seit Beginn des Ereignisses. Positive Werte geben eine Drehung im Uhrzeigersinn an; negative Werte geben eine Drehung gegen den Uhrzeigersinn an. Anfangswert: 0.0.

TouchEvent.scale Nicht standardisiert Schreibgeschützt

Abstand zwischen zwei Berührungspunkten seit Beginn des Ereignisses. Ausgedrückt als Gleitkommapunkt-Multiplikator des anfänglichen Abstands zwischen den Berührungspunkten zu Beginn des Ereignisses. Werte unter 1.0 geben eine Pinch-Bewegung nach innen an (Verkleinern). Werte über 1.0 geben eine Pinch-Bewegung nach außen an (Vergrößern). Anfangswert: 1.0.

Beispiele

Codebeispiele für diese Ereignisse sind auf der speziellen Seite verfügbar: Berührungsereignisse.

Spezifikationen

Specification
Touch Events
# event-touchcancel
Touch Events
# dom-globaleventhandlers-ontouchcancel

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
touchcancel event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support