Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : évènement touchcancel

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

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

L'évènement touchcancel est déclenché lorsqu'un ou plusieurs points de contact ont été interrompus, selon les spécificités de l'implémentation.

Quelques exemples de situations qui déclenchent un évènement touchcancel :

  • Un évènement matériel se produit et annule les activités tactiles. Cela peut inclure, par exemple, l'utilisateur·ice changeant d'application à l'aide d'une interface de commutation d'applications ou le bouton « accueil » sur un appareil mobile.
  • L'orientation de l'écran de l'appareil est modifiée alors que le contact tactile est actif.
  • Le navigateur décide que l'utilisateur·ice a commencé une interaction tactile par accident. Cela peut se produire si, par exemple, le matériel prend en charge le rejet de la paume pour empêcher qu'une main reposant sur l'écran tout en utilisant un stylet ne déclenche accidentellement des évènements.
  • La propriété CSS touch-action empêche la poursuite de l'interaction tactile.
  • Lorsque l'utilisateur·ice interagit avec trop de doigts simultanément, le navigateur peut déclencher cet évènement pour tous les points de contact existants (même si l'utilisateur·ice touche encore l'écran).

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènements.

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

ontouchcancel = (event) => { }

Type d'évènement

Un objet TouchEvent. Hérite de Event.

Event UIEvent TouchEvent

Exemples

Des exemples de code pour ces évènements sont disponibles sur la page dédiée : Évènements tactiles.

Spécifications

Spécification
Touch Events
# event-touchcancel
Touch Events
# dom-globaleventhandlers-ontouchcancel

Compatibilité des navigateurs