CKTIS / JavaScript
Koordinate miške: clientX, clientY, mousemove in mouseleave
Preberi položaj kazalca glede na prikazno območje, ob premiku posodobi vmesnik in ponastavi stanje, ko kazalec zapusti element in vse njegove potomce.
Različica: 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 in clientY sta lastnosti primerka MouseEvent, namenjeni samo branju. Podajata vodoravni in navpični položaj kazalca ob dogodku, v slikovnih pikah CSS od zgornjega levega kota prikaznega območja (viewporta). To niso koordinate dokumenta, zaslona ali elementa. Ti API-ji so del spletne platforme, ne ECMAScripta 2024; njihova razpoložljivost je odvisna od izvajalnega okolja.
mousemove se sproži, ko se kazalec premika nad elementom, tudi brez pritisnjenega gumba. Sproži se lahko zelo pogosto, zato naj obravnavalnik opravi čim manj dela. Dogodek se širi navzgor po drevesu DOM: če izvira iz potomca, lahko event.target kaže na tega potomca, med izvajanjem obravnavalnika pa event.currentTarget označuje element, na katerem je registriran poslušalec.
mouseleave se sproži, ko kazalec zapusti element in vse njegove potomce. V nasprotju z mouseout se ne širi navzgor. Premik z elementa na njegovega potomca na tem elementu ne sproži dogodka mouseleave. Pomembno je drevo DOM, ne le vidni pravokotnik. Dogodek uporabi za ponastavitev stanja, ki označuje, da je kazalec nad elementom; če element odstraniš ali zamenjaš, stanje ponastavi sam.
Za položaj glede na zgornji levi kot omejevalnega pravokotnika elementa v obravnavalniku pridobi rect z event.currentTarget.getBoundingClientRect() in izračunaj event.clientX - rect.left ter event.clientY - rect.top. Oba para uporabljata isti koordinatni sistem, zato ne prištevaj odmika zaradi drsenja. Odštevanje ne razveljavi transformacij CSS.
Primeri
<!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
Shrani primer kot datoteko HTML in jo odpri v brskalniku. Elementa nista priključena na dokument in dogodki so sintetični (`isTrusted` je `false`): ne premaknejo kazalca in ne preverjajo, kateri element je pod njim. Otrokov `mousemove` doseže nadrejeni element. Samo `mouseleave`, poslan neposredno nadrejenemu elementu, izpiše `leave`.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredna · Različica: 4
Viri
- 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