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

Ein Boolean-Wert, der angibt, ob die Alt-Taste gedrückt war, als das Berührungsereignis ausgelöst wurde.

TouchEvent.changedTouches Nur lesbar

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

Ein Boolean-Wert, der angibt, ob die Steuerungstaste gedrückt war, als das Berührungsereignis ausgelöst wurde.

TouchEvent.metaKey Nur lesbar

Ein Boolean-Wert, der angibt, ob die Metataste gedrückt war, als das Berührungsereignis ausgelöst wurde.

TouchEvent.shiftKey Nur lesbar

Ein Boolean-Wert, der angibt, ob die Umschalttaste gedrückt war, als das Berührungsereignis ausgelöst wurde.

TouchEvent.targetTouches Nur lesbar

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

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

Ä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 Nur lesbar

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

BCD tables only load in the browser