CKTIS / JavaScript
Mauskoordinaten: clientX, clientY, mousemove und mouseleave
Lies die Zeigerposition relativ zum Viewport, aktualisiere die Oberfläche bei Mausbewegungen und setze den Zustand beim Verlassen eines Elements samt seinen Nachfahren zurück.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX und clientY sind schreibgeschützte Eigenschaften einer MouseEvent-Instanz. Sie geben die horizontale und vertikale Zeigerposition zum Zeitpunkt des Ereignisses in CSS-Pixeln ab der linken oberen Ecke des Viewports an. Das sind keine Dokument-, Bildschirm- oder Elementkoordinaten. Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024; ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.
mousemove wird ausgelöst, wenn sich der Zeiger über einem Element bewegt, auch ohne gedrückte Maustaste. Das Ereignis kann sehr häufig auftreten; halte den Handler daher schlank. Es steigt im DOM-Baum auf (Bubbling): Bei einem Ereignis von einem Nachfahren kann event.target dieser Nachfahre sein, während event.currentTarget im Handler das Element mit dem Listener bezeichnet.
mouseleave wird ausgelöst, wenn der Zeiger das Element und alle seine Nachfahren verlässt. Anders als mouseout steigt es nicht im DOM-Baum auf. Beim Wechsel vom Element zu einem Nachfahren wird am Element kein mouseleave ausgelöst. Entscheidend ist der DOM-Baum, nicht nur das sichtbare Rechteck. Setze damit den Hover-Zustand zurück; wird das Element entfernt oder ersetzt, setze den Zustand selbst zurück.
Für eine Position relativ zur linken oberen Ecke des umschließenden Rechtecks ermittle im Handler rect mit event.currentTarget.getBoundingClientRect() und berechne event.clientX - rect.left und event.clientY - rect.top. Beide Wertepaare liegen im selben Koordinatensystem; addiere daher keinen Scrollversatz. Die Subtraktion macht CSS-Transformationen nicht rückgängig.
Beispiele
<!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>Ergebnis
move: 24, 36 leave
Speichere das Beispiel als HTML-Datei und öffne sie in einem Browser. Die Elemente sind nicht mit dem Dokument verbunden, und die Ereignisse sind synthetisch (`isTrusted` ist `false`): Sie bewegen den Zeiger nicht und prüfen nicht, welches Element darunter liegt. Das `mousemove` des Kindelements erreicht das Elternelement. Nur das direkt an das Elternelement gesendete `mouseleave` gibt `leave` aus.
Zugehörige Lektionen
- JavaScript · Lektion 12 · Fortgeschritten · Version: 4
Quellen
- 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