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

Document : méthode createTouch()

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

La méthode createTouch() de l'interface Document crée et retourne un nouvel objet Touch.

Note : Utilisez le constructeur TouchEvent().

Syntaxe

js
createTouch(view, target, identifier, pageX, pageY, screenX, screenY)

Paramètres

Note : Tous les paramètres sont optionnels.

view

La fenêtre (window) dans laquelle le toucher s'est produit.

target

L'objet EventTarget pour le toucher.

identifier

La valeur pour Touch.identifier.

pageX

La valeur pour Touch.pageX.

pageY

La valeur pour Touch.pageY.

screenX

La valeur pour Touch.screenX.

screenY

La valeur pour Touch.screenY.

Note : Les versions précédentes de cette méthode incluaient les paramètres supplémentaires suivants, mais ces paramètres ne sont inclus dans aucune des normes énumérées ci-dessous. Par conséquent, ces paramètres doivent être considérés comme obsolètes et ne pas être utilisés.

clientX

La valeur pour Touch.clientX.

clientY

La valeur pour Touch.clientY.

radiusX

La valeur pour Touch.radiusX.

radiusY

La valeur pour Touch.radiusY.

rotationAngle

La valeur pour Touch.rotationAngle.

force

La valeur pour Touch.force.

Valeur de retour

Un objet Touch configuré comme décrit par les paramètres d'entrée.

Exemples

Cet exemple illustre l'utilisation de la méthode Document.createTouch() pour créer des objets Touch.

Dans l'extrait de code suivant, deux objets Touch sont créés pour l'élément target.

js
const target = document.getElementById("target");

const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

Spécifications

Cette fonctionnalité ne fait partie d'aucune spécification actuelle. Elle n'est plus en voie de standardisation.

Compatibilité des navigateurs

Voir aussi