Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

MouseEvent: pulsante, coordinate e tasti modificatori

I campi di MouseEvent espongono il pulsante associato a un evento, le coordinate del puntatore relative all’area di visualizzazione e lo stato di Ctrl, Meta, Shift e Alt. Distingui button da buttons e le coordinate dell’area di visualizzazione da quelle del documento.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent è un’interfaccia della Web API del browser, non fa parte di ECMAScript in sé. Le sue proprietà di istanza sono di sola lettura. In un gestore di eventi, leggile dall’oggetto ricevuto, ad esempio event.clientX; MouseEvent.clientX è una notazione usata nella documentazione, non l’accesso a una proprietà statica.

MouseEvent.button identifica il pulsante premuto o rilasciato: 0 — principale, 1 — ausiliario, 2 — secondario, 3 — di solito Indietro, 4 — di solito Avanti. Il pulsante principale non è necessariamente quello fisicamente a sinistra, perché l’utente può modificare la configurazione. 0 può anche indicare uno stato non inizializzato. Non usare button per determinare quali pulsanti sono tenuti premuti durante mousemove; a questo serve la maschera di bit buttons.

MouseEvent.clientX e MouseEvent.clientY forniscono le coordinate orizzontale e verticale in pixel rispetto all’area di visualizzazione (viewport), non all’elemento né all’intero documento. I bordi sinistro e superiore dell’area di visualizzazione corrispondono al valore 0, anche dopo aver fatto scorrere il documento. Non dare per scontato che le coordinate debbano essere intere.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey e MouseEvent.altKey sono valori booleani che descrivono rispettivamente lo stato di Ctrl, Meta, Shift e Alt al momento dell’evento. Su macOS, Meta corrisponde a Command; sulle tastiere Windows, al tasto Windows. Il sistema operativo può intercettare Meta. Su macOS, Ctrl-clic apre un menu contestuale, quindi ctrlKey non è rilevabile in quell’evento click.

Questi campi e il costruttore sono ampiamente supportati dai browser; la presenza di Node 24 in un repository non dimostra il supporto dell’API del browser. L’esempio crea un mousedown sintetico con dati fissi: non sposta il puntatore né invia l’evento a un elemento.

Esempi

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
}));

Risultato

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti