CKTIS / JavaScript
Współrzędne myszy: clientX, clientY, mousemove i mouseleave
Odczytuj pozycję kursora względem obszaru widoku, aktualizuj interfejs przy ruchu myszy i czyść stan po opuszczeniu elementu wraz z jego potomkami.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 to właściwości instancji MouseEvent tylko do odczytu. Podają poziomą i pionową pozycję kursora w chwili zdarzenia, w pikselach CSS, względem lewego górnego rogu obszaru widoku. Nie są to współrzędne dokumentu, ekranu ani elementu. Są to interfejsy platformy webowej, a nie część ECMAScript 2024; ich dostępność zależy od środowiska.
mousemove występuje, gdy kursor porusza się nad elementem, także bez wciśniętego przycisku. Zdarzenie może występować bardzo często, więc procedura obsługi powinna wykonywać niewiele pracy. Zdarzenie propaguje się w górę drzewa (bąbelkuje): gdy pochodzi od potomka, event.target może wskazywać potomka, a event.currentTarget podczas obsługi wskazuje element, na którym zarejestrowano procedurę.
mouseleave występuje, gdy kursor opuszcza element i wszystkich jego potomków. W przeciwieństwie do mouseout nie bąbelkuje. Przejście z elementu do jego potomka nie wywołuje mouseleave na tym elemencie. Liczy się drzewo DOM, nie tylko widoczny prostokąt. Użyj tego zdarzenia do wyczyszczenia stanu najechania, ale po usunięciu lub zastąpieniu elementu wyczyść ten stan samodzielnie.
Aby uzyskać pozycję względem lewego górnego rogu prostokąta ograniczającego element, odczytaj rect za pomocą event.currentTarget.getBoundingClientRect() podczas obsługi i oblicz event.clientX - rect.left oraz event.clientY - rect.top. Obie pary wartości są w tym samym układzie, więc nie dodawaj przesunięcia przewijania. Odejmowanie nie odwraca transformacji CSS.
Przykłady
<!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>Wynik
move: 24, 36 leave
Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Elementy nie są dołączone do dokumentu, a zdarzenia są syntetyczne (`isTrusted` ma wartość `false`): nie poruszają kursorem ani nie sprawdzają, który element znajduje się pod nim. `mousemove` potomka dociera do rodzica. Tylko `mouseleave` wysłane bezpośrednio do rodzica wypisuje `leave`.
Powiązane lekcje
- JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4
Źródła
- 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