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.
addEventListener("touchcancel", (event) => {});
ontouchcancel = (event) => {};
Ereignistyp
Ein TouchEvent
. Erbt von Event
.
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
allerTouch
-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
allerTouch
-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
allerTouch
-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