CKTIS / JavaScript
MouseEvent: botón, coordenadas y teclas modificadoras
Los campos de MouseEvent permiten consultar el botón asociado a un evento, las coordenadas del puntero relativas al área de visualización y el estado de Ctrl, Meta, Shift y Alt. Distingue button de buttons y las coordenadas del área de visualización de las del documento.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKeyMouseEvent es una interfaz de la API web del navegador, no forma parte de ECMAScript en sí. Sus propiedades de instancia son de solo lectura. En un controlador de eventos, léelas del objeto recibido, por ejemplo, event.clientX; MouseEvent.clientX es una notación de la documentación, no el acceso a una propiedad estática.
MouseEvent.button identifica el botón que se ha pulsado o soltado: 0 — principal, 1 — auxiliar, 2 — secundario, 3 — normalmente Atrás, 4 — normalmente Adelante. El botón principal no tiene por qué ser físicamente el de la izquierda, ya que el usuario puede cambiar la configuración. 0 también puede indicar un estado sin inicializar. No uses button para determinar qué botones se mantienen pulsados durante mousemove; para eso se usa la máscara de bits buttons.
MouseEvent.clientX y MouseEvent.clientY proporcionan las coordenadas horizontal y vertical en píxeles con respecto al área de visualización (viewport), no al elemento ni al documento completo. Los bordes izquierdo y superior del área de visualización corresponden al valor 0, incluso después de desplazar el documento. No des por hecho que las coordenadas deban ser números enteros.
MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey y MouseEvent.altKey son valores booleanos que describen, respectivamente, el estado de Ctrl, Meta, Shift y Alt cuando se produce el evento. Meta es Command en macOS y la tecla Windows en los teclados de Windows. El sistema operativo puede interceptar Meta. En macOS, Ctrl y clic abre un menú contextual, por lo que ctrlKey no se puede detectar en ese evento click.
Estos campos y el constructor son ampliamente compatibles con los navegadores; que Node 24 esté presente en un repositorio no demuestra la compatibilidad con la API del navegador. El ejemplo crea un mousedown sintético con datos fijos: no mueve el puntero ni envía el evento a un elemento.
Ejemplos
const event = new MouseEvent("mousedown", {
button: 0,
clientX: 120,
clientY: 80,
ctrlKey: true,
metaKey: false,
shiftKey: true,
altKey: false
});
console.log(JSON.stringify({
button: event.button,
x: event.clientX,
y: event.clientY,
ctrl: event.ctrlKey,
meta: event.metaKey,
shift: event.shiftKey,
alt: event.altKey
}));Resultado
{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.