CKTIS / JavaScript
Coordinate del mouse: clientX, clientY, mousemove e mouseleave
Leggi la posizione del puntatore nel viewport, aggiorna l’interfaccia durante il movimento e azzera lo stato quando il puntatore esce da un elemento e dai suoi discendenti.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX e clientY sono proprietà di sola lettura di un’istanza di MouseEvent. Indicano la posizione orizzontale e verticale del puntatore al momento dell’evento, in pixel CSS a partire dall’angolo in alto a sinistra del viewport. Non sono coordinate del documento, dello schermo o dell’elemento. Queste API appartengono alla piattaforma web, non a ECMAScript 2024; la loro disponibilità dipende dall’ambiente di esecuzione.
mousemove si attiva quando il puntatore si muove sopra un elemento, anche senza pulsanti premuti. Può attivarsi molto spesso, quindi limita il lavoro del gestore. L’evento risale l’albero DOM: se proviene da un discendente, event.target può indicare quel discendente, mentre event.currentTarget indica, durante l’esecuzione del gestore, l’elemento su cui è registrato il listener.
mouseleave si attiva quando il puntatore esce dall’elemento e da tutti i suoi discendenti. A differenza di mouseout, non risale l’albero DOM. Passare dall’elemento a un suo discendente non attiva mouseleave sull’elemento. Conta l’albero DOM, non solo il rettangolo visibile. Usa questo evento per azzerare lo stato di hover, ma azzeralo esplicitamente se l’elemento viene rimosso o sostituito.
Per ottenere una posizione relativa all’angolo in alto a sinistra del rettangolo che racchiude l’elemento, ricava rect con event.currentTarget.getBoundingClientRect() nel gestore e calcola event.clientX - rect.left e event.clientY - rect.top. Le due coppie usano lo stesso sistema di coordinate, quindi non aggiungere lo scostamento dovuto allo scorrimento. La sottrazione non annulla le trasformazioni CSS.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>Mouse event propagation</title>
<pre id="output"></pre>
<script>
(() => {
const output = document.getElementById("output");
const lines = [];
function log(line) {
lines.push(line);
console.log(line);
}
const area = document.createElement("div");
const child = document.createElement("span");
area.append(child);
area.addEventListener("mousemove", (event) => {
log(`move: ${event.clientX}, ${event.clientY}`);
});
area.addEventListener("mouseleave", () => log("leave"));
child.dispatchEvent(new MouseEvent("mousemove", {
bubbles: true, clientX: 24, clientY: 36
}));
child.dispatchEvent(new MouseEvent("mouseleave", { bubbles: false }));
area.dispatchEvent(new MouseEvent("mouseleave", { bubbles: false }));
output.textContent = lines.join("\n");
})();
</script>Risultato
move: 24, 36 leave
Salva l’esempio come file HTML e aprilo in un browser. Gli elementi non sono collegati al documento e gli eventi sono sintetici (`isTrusted` vale `false`): non muovono il puntatore e non verificano quale elemento si trovi sotto di esso. Il `mousemove` del figlio raggiunge il genitore. Solo il `mouseleave` inviato direttamente al genitore stampa `leave`.
Lezioni correlate
- JavaScript · Lezione 12 · Avanzato · Versione: 4
Fonti
- HTML Standard — Event handlers
- MouseEvent: clientX property
- MouseEvent: clientY property
- Coordinate systems
- Element: mousemove event
- Element: mouseleave event
- Element: mouseout event
- Event: currentTarget property
- Element: getBoundingClientRect() method
- MouseEvent: MouseEvent() constructor
- EventTarget: dispatchEvent() method