CKTIS / JavaScript
Koordinate miša: clientX, clientY, mousemove i mouseleave
Očitaj položaj pokazivača u odnosu na područje prikaza, ažuriraj sučelje pri pomicanju i poništi stanje kad pokazivač napusti element i sve njegove potomke.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX i clientY svojstva su instance MouseEvent samo za čitanje. Daju vodoravni i okomiti položaj pokazivača u trenutku događaja, u CSS pikselima od gornjeg lijevog kuta područja prikaza (viewporta). To nisu koordinate dokumenta, zaslona ni elementa. Ta su sučelja dio web-platforme, a ne ECMAScripta 2024; dostupnost ovisi o okruženju izvođenja.
mousemove se okida kad se pokazivač pomiče iznad elementa, čak i bez pritisnute tipke miša. Može se okidati vrlo često, pa neka funkcija za obradu radi što manje posla. Događaj se širi prema gore kroz stablo DOM-a: ako dolazi od potomka, event.target može označavati tog potomka, dok event.currentTarget tijekom obrade označava element na kojem je registriran slušatelj.
mouseleave se okida kad pokazivač napusti element i sve njegove potomke. Za razliku od mouseout, ne širi se prema gore. Prijelaz s elementa na njegova potomka ne okida mouseleave na tom elementu. Važno je stablo DOM-a, a ne samo vidljivi pravokutnik. Ovim događajem poništi stanje koje označava da je pokazivač nad elementom, ali poništi ga izravno ako se element ukloni ili zamijeni.
Za položaj u odnosu na gornji lijevi kut graničnog pravokutnika elementa dohvati rect pomoću event.currentTarget.getBoundingClientRect() unutar funkcije za obradu pa izračunaj event.clientX - rect.left i event.clientY - rect.top. Oba para koriste isti koordinatni sustav, pa ne pribrajaj pomak nastao pomicanjem stranice. Oduzimanje ne poništava CSS transformacije.
Primjeri
<!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>Rezultat
move: 24, 36 leave
Spremi primjer kao HTML datoteku i otvori je u pregledniku. Elementi nisu povezani s dokumentom, a događaji su sintetički (`isTrusted` je `false`): ne pomiču pokazivač i ne provjeravaju koji se element nalazi ispod njega. `mousemove` podređenog elementa stiže do roditeljskog. Samo `mouseleave` poslan izravno roditeljskom elementu ispisuje `leave`.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredno · Verzija: 4
Izvori
- 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