Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

MouseEvent: código del botón y coordenadas del área visible

Usa `button` para identificar el botón que se pulsó o soltó, y `clientX` y `clientY` para leer dónde ocurrió el evento de ratón dentro del área visible.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

event.button
 event.clientX
 event.clientY

new MouseEvent(type, { button, buttons, clientX, clientY })

button, clientX y clientY son propiedades de solo lectura de una instancia de MouseEvent. En un controlador, lee event.button, no MouseEvent.button. MouseEvent es una API web, no forma parte de ECMAScript 2024. Si el entorno no ofrece el constructor y el nombre no está definido, new MouseEvent(...) lanza un ReferenceError.

En eventos como mousedown y mouseup, button identifica el botón pulsado o soltado: 0 principal (normalmente izquierdo), 1 auxiliar (normalmente central), 2 secundario (normalmente derecho), 3 cuarto (normalmente Atrás) y 4 quinto (normalmente Adelante). Son roles lógicos, no posiciones físicas fijas. En mousemove, button === 0 no demuestra que el botón principal esté pulsado. Usa la máscara de bits buttons: 0 significa que no hay botones pulsados y (event.buttons & 1) !== 0 comprueba el botón principal.

clientX y clientY son las coordenadas horizontal y vertical del evento, respectivamente, en píxeles CSS. La esquina superior izquierda del área visible (viewport) es (0, 0); X aumenta hacia la derecha e Y hacia abajo. El desplazamiento no mueve ese origen, pero puede cambiar las coordenadas de cliente de un mismo punto del documento en un evento posterior. pageX y pageY se refieren al documento, y screenX y screenY, a la pantalla. Las coordenadas de cliente no son relativas al elemento de destino.

Con new MouseEvent(type, options) estableces los valores iniciales de un evento sintético. Crear el objeto no despacha el evento ni mueve el puntero. El evento tiene isTrusted === false y no concede activación de usuario.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>MouseEvent example</title>
<pre id="output"></pre>
<script>
  {
    const event = new MouseEvent("mouseup", {
      button: 2,
      buttons: 0,
      clientX: 120,
      clientY: 45,
    });

    document.getElementById("output").textContent =
      `button=${event.button}, buttons=${event.buttons}, clientX=${event.clientX}, clientY=${event.clientY}`;
  }
</script>

Resultado

button=2, buttons=0, clientX=120, clientY=45

Guarda el ejemplo como archivo HTML y ábrelo en un navegador. El `mouseup` sintético describe que se soltó el botón secundario en `(120, 45)`; `buttons=0` indica que no queda ningún botón pulsado. No hace falta hacer clic.

Lecciones relacionadas

  • JavaScript · Lección 35 · Intermedio · Versión: 3

Fuentes