CKTIS / JavaScript
Координати на мишката: clientX, clientY, mousemove и mouseleave
Отчитай позицията на курсора спрямо видимата област, обновявай интерфейса при движение и изчиствай състоянието при напускане на елемента и неговите потомци.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX и clientY са свойства само за четене на екземпляр на MouseEvent. Те дават хоризонталната и вертикалната позиция на курсора в момента на събитието, в CSS пиксели от горния ляв ъгъл на видимата област (viewport). Това не са координати спрямо документа, екрана или елемента. Тези API са част от уеб платформата, а не от ECMAScript 2024; наличността им зависи от средата за изпълнение.
mousemove се задейства, когато курсорът се движи над елемент, дори без натиснат бутон на мишката. Събитието може да възниква много често, затова обработчикът трябва да върши малко работа. То се разпространява нагоре по DOM дървото: ако идва от потомък, event.target може да сочи към този потомък, а event.currentTarget по време на обработката сочи към елемента с регистрирания обработчик.
mouseleave се задейства, когато курсорът напусне елемента и всички негови потомци. За разлика от mouseout, то не се разпространява нагоре. Преминаването от елемента към негов потомък не задейства mouseleave върху елемента. От значение е DOM дървото, а не само видимият правоъгълник. Използвай събитието, за да изчистиш състоянието, което показва, че курсорът е над елемента, но го изчисти изрично, ако елементът бъде премахнат или заменен.
За позиция спрямо горния ляв ъгъл на ограждащия правоъгълник на елемента вземи rect чрез event.currentTarget.getBoundingClientRect() в обработчика и изчисли event.clientX - rect.left и event.clientY - rect.top. Двете двойки използват една и съща координатна система, затова не добавяй отместването от превъртането. Изваждането не отменя CSS трансформациите.
Примери
<!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>Резултат
move: 24, 36 leave
Запази примера като HTML файл и го отвори в браузър. Елементите не са свързани с документа, а събитията са синтетични (`isTrusted` е `false`): те не местят курсора и не проверяват кой елемент се намира под него. `mousemove` на дъщерния елемент достига родителския. Само `mouseleave`, изпратено директно до родителския елемент, извежда `leave`.
Свързани уроци
- JavaScript · Урок 12 · Напреднало · Версия: 4
Източници
- 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