CKTIS / JavaScript
Súradnice myši: clientX, clientY, mousemove a mouseleave
Zisti polohu kurzora vzhľadom na oblasť zobrazenia, aktualizuj rozhranie pri pohybe a vymaž stav, keď kurzor opustí prvok aj všetkých jeho potomkov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX a clientY sú vlastnosti inštancie MouseEvent určené iba na čítanie. Udávajú vodorovnú a zvislú polohu kurzora v okamihu udalosti, v CSS pixeloch od ľavého horného rohu oblasti zobrazenia (viewportu). Nie sú to súradnice dokumentu, obrazovky ani prvku. Tieto API patria k webovej platforme, nie k ECMAScriptu 2024; ich dostupnosť závisí od prostredia vykonávania.
mousemove nastane, keď sa kurzor pohybuje nad prvkom, aj bez stlačeného tlačidla. Udalosť môže nastať veľmi často, preto by jej obsluha mala robiť čo najmenej práce. Udalosť prebubláva stromom DOM: ak pochádza od potomka, event.target môže označovať tohto potomka, kým event.currentTarget počas obsluhy označuje prvok, na ktorom je zaregistrovaný poslucháč.
mouseleave nastane, keď kurzor opustí prvok aj všetkých jeho potomkov. Na rozdiel od mouseout neprebubláva. Prechod z prvku na jeho potomka nevyvolá mouseleave na tomto prvku. Rozhoduje strom DOM, nielen viditeľný obdĺžnik. Udalosť použi na vymazanie stavu prejdenia myšou, ale pri odstránení alebo nahradení prvku stav vymaž priamo.
Ak chceš polohu vzhľadom na ľavý horný roh ohraničujúceho obdĺžnika prvku, získaj v obsluhe rect cez event.currentTarget.getBoundingClientRect() a vypočítaj event.clientX - rect.left a event.clientY - rect.top. Obe dvojice používajú rovnakú súradnicovú sústavu, preto nepripočítavaj posun spôsobený rolovaním. Odčítanie nezruší transformácie CSS.
Príklady
<!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>Výsledok
move: 24, 36 leave
Ulož príklad ako súbor HTML a otvor ho v prehliadači. Prvky nie sú pripojené k dokumentu a udalosti sú syntetické (`isTrusted` je `false`): nehýbu kurzorom ani nezisťujú, ktorý prvok je pod ním. `mousemove` potomka dorazí k rodičovskému prvku. Iba `mouseleave` odoslaná priamo rodičovskému prvku vypíše `leave`.
Súvisiace lekcie
- JavaScript · Lekcia 12 · Pokročilá · Verzia: 4
Zdroje
- 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