CKTIS / JavaScript
MouseEvent: pulsanti del mouse e tasti modificatori
Individua il pulsante associato all’evento e lo stato di Ctrl, Meta, Maiusc e Alt. Distingui il codice `button` dalla maschera di bit `buttons`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey e altKey sono proprietà di istanza di sola lettura di MouseEvent. Si leggono sull’oggetto evento, ad esempio con event.button. Appartengono all’API web, non a ECMAScript 2024, quindi la loro disponibilità dipende dall’ambiente di esecuzione.
Negli eventi di pressione o rilascio, come mousedown e mouseup, button contiene il codice di un solo pulsante: 0 principale (di solito a sinistra), 1 ausiliario (di solito centrale), 2 secondario (di solito a destra), 3 quarto (tipicamente Indietro), 4 quinto (tipicamente Avanti). Sono ruoli, non posizioni fisiche. In mousemove, button non indica in modo attendibile se un pulsante è tenuto premuto. buttons è una maschera dei pulsanti premuti: 0 significa nessuno; 1, 2, 4, 8, 16 rappresentano rispettivamente il principale, il secondario, l’ausiliario, il quarto e il quinto. (event.buttons & 1) !== 0 verifica il bit del pulsante principale.
ctrlKey indica Ctrl, metaKey indica Meta (Comando su macOS, tasto Windows su Windows), shiftKey indica Maiusc e altKey indica Alt (Opzione su macOS). Ogni valore è true se l’evento segnala il tasto come premuto, altrimenti false. È lo stato registrato nell’evento, non una lettura della tastiera in tempo reale. Il sistema operativo può intercettare un gesto: su macOS, Ctrl+clic può aprire un menu contestuale invece di produrre un normale click. Un click da solo non dimostra che sia stato usato il mouse: può provenire anche dalla tastiera o da un’interazione tattile.
In new MouseEvent(type, options), le opzioni button e buttons omesse valgono 0, mentre le opzioni omesse dei modificatori valgono false. Un evento sintetico ha isTrusted === false e non conferisce l’attivazione utente richiesta da alcune API.
Esempi
// Use native MouseEvent in browsers. In Node.js, model only the fields read below.
const DemoMouseEvent = globalThis.MouseEvent ?? class extends Event {
constructor(type, {
button = 0, buttons = 0,
ctrlKey = false, metaKey = false, shiftKey = false, altKey = false,
} = {}) {
super(type);
const fields = { button, buttons, ctrlKey, metaKey, shiftKey, altKey };
for (const [key, value] of Object.entries(fields)) {
Object.defineProperty(this, key, { value });
}
}
};
for (const event of [
new DemoMouseEvent("mousedown", { button: 1, buttons: 6, ctrlKey: true, shiftKey: true }),
new DemoMouseEvent("mousemove", { buttons: 2, metaKey: true, altKey: true }),
]) {
const { type, button, buttons, ctrlKey, metaKey, shiftKey, altKey } = event;
console.log(JSON.stringify({ type, button, buttons, ctrlKey, metaKey, shiftKey, altKey }));
}Risultato
{"type":"mousedown","button":1,"buttons":6,"ctrlKey":true,"metaKey":false,"shiftKey":true,"altKey":false}
{"type":"mousemove","button":0,"buttons":2,"ctrlKey":false,"metaKey":true,"shiftKey":false,"altKey":true}Esegui il codice nella console del browser. Nella prima riga, `button: 1` indica il pulsante ausiliario e `buttons: 6` combina i bit del secondario (`2`) e dell’ausiliario (`4`). Nella seconda, `button: 0` è il valore predefinito, mentre la maschera indica solo il secondario. Nessuno dei due eventi viene inviato.
Lezioni correlate
- JavaScript · Lezione 37 · Avanzato · Versione: 4
- JavaScript · Lezione 38 · Avanzato · Versione: 4
- JavaScript · Lezione 36 · Intermedio · Versione: 3
- JavaScript · Lezione 37 · Intermedio · Versione: 3
Fonti
- MouseEvent: button property
- MouseEvent: ctrlKey property
- MouseEvent: metaKey property
- MouseEvent: shiftKey property
- MouseEvent: altKey property
- MouseEvent: buttons property
- MouseEvent: MouseEvent() constructor
- Element: click event
- Event: isTrusted property
- HTML Standard: Tracking user activation
- ECMAScript 2024 Language Specification: Hosts and Implementations