CKTIS / JavaScript
MouseEvent: tipke miša i modifikacijske tipke
Saznaj na koju se tipku miša odnosi događaj i jesu li Ctrl, Meta, Shift ili Alt bili aktivni. Razlikuj kod `button` od bitne maske `buttons`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey i altKey svojstva su instance MouseEvent dostupna samo za čitanje. Čitaju se iz objekta događaja, primjerice pomoću event.button. Dio su web API-ja, a ne ECMAScripta 2024, pa njihova dostupnost ovisi o izvršnom okruženju.
U događajima pritiska ili otpuštanja tipke miša, kao što su mousedown i mouseup, button sadrži kod jedne tipke: 0 primarna (obično lijeva), 1 pomoćna (obično srednja), 2 sekundarna (obično desna), 3 četvrta (najčešće Natrag), 4 peta (najčešće Naprijed). To su uloge, a ne fizički položaji. U događaju mousemove vrijednost button nije pouzdan pokazatelj je li tipka pritisnuta. buttons je bitna maska pritisnutih tipki: 0 znači da nijedna nije pritisnuta, a 1, 2, 4, 8, 16 redom označavaju primarnu, sekundarnu, pomoćnu, četvrtu i petu. (event.buttons & 1) !== 0 provjerava bit primarne tipke.
ctrlKey označava Ctrl, metaKey označava Meta (Command na macOS-u, tipka Windows u sustavu Windows), shiftKey označava Shift, a altKey Alt (Option na macOS-u). Svaka je vrijednost true ako događaj prijavljuje da je tipka pritisnuta, inače je false. To je stanje zabilježeno u događaju, a ne očitanje tipkovnice u stvarnom vremenu. Operacijski sustav može presresti gestu: na macOS-u Ctrl+klik može otvoriti kontekstni izbornik umjesto da proizvede uobičajeni click. Sam click ne dokazuje upotrebu miša: može nastati i upotrebom tipkovnice ili dodirom.
U new MouseEvent(type, options) izostavljene opcije button i buttons imaju zadanu vrijednost 0, a izostavljene opcije modifikatora false. Sintetički događaj ima isTrusted === false i ne daje korisničku aktivaciju koju zahtijevaju neki API-ji.
Primjeri
// 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 }));
}Rezultat
{"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}Pokreni kôd u konzoli preglednika. U prvom retku `button: 1` označava pomoćnu tipku, a `buttons: 6` kombinira bitove sekundarne (`2`) i pomoćne (`4`) tipke. U drugom je retku `button: 0` zadana vrijednost, dok maska označava samo sekundarnu tipku. Nijedan se događaj ne šalje.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredno · Verzija: 4
- JavaScript · Lekcija 38 · Napredno · Verzija: 4
- JavaScript · Lekcija 36 · Srednje · Verzija: 3
- JavaScript · Lekcija 37 · Srednje · Verzija: 3
Izvori
- 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