Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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