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