CKTIS / JavaScript
PointerEvent : identifiant du pointeur et coordonnées dans la zone d’affichage
`pointerId` distingue les pointeurs actifs en même temps. `clientX` et `clientY` situent l’événement dans la zone d’affichage, en pixels CSS.
Version : Current web platform; runtime support varies
Syntaxe
event.pointerId
event.clientX
event.clientYpointerId, clientX et clientY sont des propriétés en lecture seule d’une instance de PointerEvent. pointerId est un identifiant numérique qui distingue les pointeurs actifs en même temps, par exemple deux doigts sur un écran. Un identifiant peut être réutilisé après la fin d’une interaction. Ne l’utilisez pas comme identifiant permanent du périphérique et n’en déduisez pas son type. Pour un événement généré par le navigateur, -1 indique qu’aucun périphérique de pointage n’en est à l’origine, par exemple lorsqu’un bouton est activé au clavier.
clientX (horizontale) et clientY (verticale) sont héritées de MouseEvent, même pour les interactions tactiles ou au stylet. Elles situent l’événement en pixels CSS depuis le coin supérieur gauche de la zone d’affichage (viewport) et augmentent respectivement vers la droite et vers le bas. Contrairement à pageX et pageY, elles ne sont pas relatives au document. Elles ne sont pas non plus relatives à l’élément cible ni à l’écran. Faire défiler le document change les coordonnées d’un point fixe du document dans la zone d’affichage, mais pas l’origine de cette zone.
Pour suivre plusieurs interactions, enregistrez à chaque pointerdown la position initiale dans une Map avec pointerId comme clé. Lors de pointermove, recherchez cette clé et ignorez l’événement si aucune entrée ne correspond. Supprimez l’entrée lors de pointerup ou de pointercancel. PointerEvent et les propriétés de coordonnées héritées de MouseEvent relèvent des API de la plateforme web. Ni ces propriétés ni l’exemple ne nécessitent ECMAScript 2024. La disponibilité de ces API dépend de l’environnement d’exécution.
Exemples
(() => {
const target = new EventTarget();
const starts = new Map();
target.addEventListener("pointerdown", ({ pointerId, clientX, clientY }) => {
starts.set(pointerId, { x: clientX, y: clientY });
});
target.addEventListener("pointermove", ({ pointerId, clientX, clientY }) => {
const start = starts.get(pointerId);
if (!start) return;
console.log(`${pointerId}: dx=${clientX - start.x}, dy=${clientY - start.y}`);
});
const end = ({ pointerId }) => { starts.delete(pointerId); };
target.addEventListener("pointerup", end);
target.addEventListener("pointercancel", end);
const send = (type, pointerId, clientX, clientY) => {
const fields = { pointerId, clientX, clientY };
// Without PointerEvent, use a plain Event to exercise the same listeners.
const event = typeof PointerEvent === "function"
? new PointerEvent(type, fields)
: Object.assign(new Event(type), fields);
target.dispatchEvent(event);
};
send("pointerdown", 7, 100, 80);
send("pointerdown", 8, 200, 150);
send("pointermove", 7, 112, 75);
send("pointermove", 8, 197, 159);
send("pointercancel", 8, 197, 159);
send("pointermove", 8, 198, 160);
send("pointerup", 7, 112, 75);
console.log(`tracked=${starts.size}`);
})();Résultat
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Exécutez le code dans Node.js ou dans la console d’un navigateur. Si `PointerEvent` est indisponible, le code envoie de simples objets `Event` contenant les trois champs aux mêmes gestionnaires. Les événements synthétiques ont `isTrusted === false` et ne déplacent aucun pointeur physique. Le code affiche le déplacement depuis le début de chaque interaction. Le mouvement du pointeur `8` après l’annulation est ignoré ; `tracked=0` signifie qu’il ne reste aucune entrée.
Leçons associées
- JavaScript · Leçon 35 · Avancé · Version : 4