CKTIS / JavaScript
Coordenadas del ratón: clientX, clientY, mousemove y mouseleave
Lee la posición del puntero respecto al área visible, actualiza la interfaz al mover el ratón y restablece el estado al salir de un elemento y sus descendientes.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;clientX y clientY son propiedades de solo lectura de una instancia de MouseEvent. Indican la posición horizontal y vertical del puntero en el momento del evento, en píxeles CSS desde la esquina superior izquierda del área visible (viewport). No son coordenadas del documento, de la pantalla ni del elemento. Estas API son de la plataforma web, no de ECMAScript 2024; su disponibilidad depende del entorno de ejecución.
mousemove se dispara cuando el puntero se mueve sobre un elemento, incluso sin pulsar ningún botón. Puede dispararse con mucha frecuencia, así que mantén ligero el manejador. El evento se propaga hacia arriba por el DOM: si procede de un descendiente, event.target puede ser ese descendiente, mientras que event.currentTarget identifica durante el manejo el elemento donde se registró el listener.
mouseleave se dispara cuando el puntero sale del elemento y de todos sus descendientes. A diferencia de mouseout, no se propaga hacia arriba. Pasar del elemento a un descendiente no dispara mouseleave en ese elemento. Importa el árbol DOM, no solo el rectángulo visible. Usa este evento para restablecer el estado de puntero encima, pero restablécelo tú si el elemento se elimina o se sustituye.
Para obtener una posición relativa a la esquina superior izquierda del rectángulo delimitador, obtén rect con event.currentTarget.getBoundingClientRect() dentro del manejador y calcula event.clientX - rect.left y event.clientY - rect.top. Ambos pares usan el mismo sistema de coordenadas, así que no sumes el desplazamiento de la página. Restar no deshace las transformaciones CSS.
Ejemplos
<!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>Resultado
move: 24, 36 leave
Guarda el ejemplo como archivo HTML y ábrelo en un navegador. Los elementos no están conectados al documento y los eventos son sintéticos (`isTrusted` vale `false`): no mueven el puntero ni comprueban qué elemento hay debajo. El `mousemove` del hijo llega al padre. Solo el `mouseleave` enviado directamente al padre imprime `leave`.
Lecciones relacionadas
- JavaScript · Lección 12 · Avanzado · Versión: 4
Fuentes
- 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