CKTIS / JavaScript
PointerEvent: identificatore del puntatore e coordinate del viewport
`pointerId` distingue i puntatori attivi nello stesso momento, mentre `clientX` e `clientY` indicano la posizione dell’evento nel viewport in pixel CSS.
Versione: Current web platform; runtime support varies
Sintassi
event.pointerId
event.clientX
event.clientYpointerId, clientX e clientY sono proprietà di sola lettura di un’istanza di PointerEvent. pointerId è un identificatore numerico che distingue un puntatore dagli altri puntatori attivi nello stesso momento, ad esempio due dita sullo schermo. Un identificatore può essere riutilizzato dopo la fine di un’interazione. Non usarlo come identificatore permanente del dispositivo e non dedurne il tipo di dispositivo. Negli eventi generati dal browser, -1 indica che l’evento non proviene da un dispositivo di puntamento, come quando si attiva un pulsante con la tastiera.
clientX (orizzontale) e clientY (verticale) sono ereditate da MouseEvent, anche per gli input tattili o con penna. Indicano la posizione dell’evento in pixel CSS a partire dall’angolo in alto a sinistra del viewport e aumentano rispettivamente verso destra e verso il basso. A differenza di pageX e pageY, non sono relative al documento. Non sono nemmeno relative all’elemento destinatario o allo schermo. Scorrere il documento cambia le coordinate di un suo punto fisso nel viewport, non l’origine del viewport.
Per seguire più interazioni, a ogni pointerdown salva la posizione iniziale in una Map con pointerId come chiave. Su pointermove, cerca quella chiave e ignora l’evento se non c’è una voce corrispondente. Elimina la voce sia su pointerup sia su pointercancel. PointerEvent e le proprietà delle coordinate ereditate da MouseEvent appartengono alle API della piattaforma web. Né queste proprietà né l’esempio richiedono ECMAScript 2024. La disponibilità delle API dipende dall’ambiente di esecuzione.
Esempi
(() => {
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}`);
})();Risultato
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Esegui il codice in Node.js o nella console di un browser. Se `PointerEvent` non è disponibile, il codice invia semplici oggetti `Event` con i tre campi agli stessi gestori. Gli eventi sintetici hanno `isTrusted === false` e non spostano un puntatore fisico. Il codice mostra lo spostamento dall’inizio di ogni interazione. Il movimento del puntatore `8` dopo l’annullamento viene ignorato; `tracked=0` indica che non rimane alcuna voce.
Lezioni correlate
- JavaScript · Lezione 35 · Avanzato · Versione: 4