CKTIS / JavaScript
Souřadnice myši: clientX, clientY, mousemove a mouseleave
Získej polohu kurzoru vůči oblasti zobrazení, aktualizuj rozhraní při pohybu a vymaž stav, když kurzor opustí prvek i všechny jeho potomky.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 jsou vlastnosti instance MouseEvent určené jen pro čtení. Udávají vodorovnou a svislou polohu kurzoru v okamžiku události, v CSS pixelech od levého horního rohu oblasti zobrazení (viewportu). Nejde o souřadnice dokumentu, obrazovky ani prvku. Tato API patří k webové platformě, nikoli k ECMAScriptu 2024; jejich dostupnost závisí na běhovém prostředí.
mousemove nastane, když se kurzor pohybuje nad prvkem, i bez stisknutého tlačítka. Událost může nastávat velmi často, proto by její obsluha měla dělat co nejméně práce. Událost probublává stromem DOM: pokud pochází od potomka, event.target může označovat tohoto potomka, zatímco event.currentTarget během obsluhy označuje prvek, na kterém je posluchač registrován.
mouseleave nastane, když kurzor opustí prvek i všechny jeho potomky. Na rozdíl od mouseout neprobublává. Přechod z prvku na jeho potomka nevyvolá mouseleave na tomto prvku. Rozhoduje strom DOM, ne jen viditelný obdélník. Událost použij k vymazání stavu najetí myší, ale při odebrání nebo nahrazení prvku ho vymaž přímo.
Pro polohu vůči levému hornímu rohu ohraničujícího obdélníku prvku získej v obsluze rect pomocí event.currentTarget.getBoundingClientRect() a vypočti event.clientX - rect.left a event.clientY - rect.top. Obě dvojice používají stejnou soustavu souřadnic, proto nepřičítej posun způsobený rolováním. Odečtení nezruší transformace CSS.
Pří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ýsledek
move: 24, 36 leave
Ulož příklad jako soubor HTML a otevři ho v prohlížeči. Prvky nejsou připojené k dokumentu a události jsou syntetické (`isTrusted` je `false`): nehýbou kurzorem ani nezjišťují, který prvek je pod ním. `mousemove` potomka dorazí k rodičovskému prvku. Pouze `mouseleave` odeslaná přímo rodičovskému prvku vypíše `leave`.
Související lekce
- JavaScript · Lekce 12 · Pokročilá · Verze: 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