Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Element: touchcancel-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Das touchcancel-Ereignis wird ausgelöst, wenn ein oder mehrere Berührungspunkte auf implementierungsspezifische Weise unterbrochen werden.

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

  • Ein Hardwareereignis bricht die Berührungsaktivitäten ab. Dies kann beispielsweise geschehen, wenn die Person über eine Oberfläche zum Wechseln zwischen Anwendungen oder die „Home“-Taste eines Mobilgeräts zu einer anderen Anwendung wechselt.
  • Die Bildschirmausrichtung des Geräts ändert sich während einer aktiven Berührung.
  • Der Browser stellt fest, dass die Berührungseingabe versehentlich begonnen wurde. Das kann beispielsweise vorkommen, wenn die Hardware Handballenerkennung unterstützt, damit eine auf dem Display aufliegende Hand bei der Verwendung eines Eingabestifts nicht versehentlich Ereignisse auslöst.
  • Die CSS-Eigenschaft touch-action verhindert, dass die Eingabe fortgesetzt wird.
  • Wenn die Person den Bildschirm mit zu vielen Fingern gleichzeitig berührt, kann der Browser dieses Ereignis für alle vorhandenen Zeiger auslösen (auch wenn die Person den Bildschirm weiterhin berührt).

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie ihn der Ereignishandler-Eigenschaft der Schnittstelle zuweisen:

js
ontouchcancel = (event) => { }

Ereignistyp

Ein TouchEvent. Erbt von Event.

Event UIEvent TouchEvent

Beispiele

Codebeispiele für diese Ereignisse finden Sie auf der entsprechenden Seite: Touch-Ereignisse.

Spezifikationen

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

Browser-Kompatibilität