Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

MouseEvent: codice del pulsante e coordinate della viewport

Usa `button` per individuare il pulsante premuto o rilasciato e `clientX` e `clientY` per leggere la posizione dell’evento del mouse nella viewport.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

event.button
 event.clientX
 event.clientY

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

button, clientX e clientY sono proprietà di sola lettura delle istanze di MouseEvent. In un gestore di eventi, leggi event.button, non MouseEvent.button. MouseEvent è un’API web, non fa parte di ECMAScript 2024. Se l’ambiente non fornisce il costruttore e il nome non è definito, new MouseEvent(...) genera un ReferenceError.

Negli eventi come mousedown e mouseup, button identifica il pulsante premuto o rilasciato: 0 primario (di solito sinistro), 1 ausiliario (di solito centrale), 2 secondario (di solito destro), 3 quarto (di solito Indietro) e 4 quinto (di solito Avanti). Sono ruoli logici, non posizioni fisiche fisse. In mousemove, button === 0 non dimostra che il pulsante primario sia tenuto premuto. Usa la maschera di bit buttons: 0 indica che nessun pulsante è premuto e (event.buttons & 1) !== 0 verifica lo stato del pulsante primario.

clientX e clientY sono, rispettivamente, le coordinate orizzontale e verticale dell’evento, in pixel CSS. L’angolo in alto a sinistra della viewport è (0, 0); X cresce verso destra e Y verso il basso. Lo scorrimento non sposta l’origine, ma in un evento successivo può cambiare le coordinate client dello stesso punto del documento. pageX e pageY sono relative al documento, screenX e screenY allo schermo. Le coordinate client non sono relative all’elemento destinatario.

Usa new MouseEvent(type, options) per impostare i valori iniziali di un evento sintetico. Creare l’oggetto non invia l’evento né sposta il puntatore. L’evento ha isTrusted === false e non conferisce l’attivazione utente.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML e aprilo in un browser. Il `mouseup` sintetico descrive il rilascio del pulsante secondario in `(120, 45)`; `buttons=0` indica che nessun pulsante resta premuto. Non serve fare clic.

Lezioni correlate

  • JavaScript · Lezione 35 · Intermedio · Versione: 3

Fonti