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 createTouchList()

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 createTouchList() de l'interface Document crée et retourne un nouvel objet TouchList.

Syntaxe

js
createTouchList(touch1)
createTouchList(touch1, touch2)
createTouchList(touch1, touch2, /* …, */ touchN)

Paramètres

touch1, …, touchN

Zéro ou plusieurs objets Touch. Firefox accepte également un tableau d'objets Touch.

Valeur de retour

Un objet TouchList contenant les objets Touch définis par les paramètres touchs.

Exemples

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

Dans l'extrait de code suivant, certains objets Touch sont créés pour l'élément target et ces points de contact sont ensuite utilisés pour créer des objets TouchList.

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

// Créez quelques points de contact
const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

// Créez un objet TouchList vide
const list0 = document.createTouchList();

// Créez un objet TouchList avec un seul objet Touch
const list1 = document.createTouchList(touch1);

// Créez un objet TouchList avec deux objets Touch
const list2 = document.createTouchList(touch1, touch2);

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