CKTIS / JavaScript
MouseEvent: gumbi miške in modifikacijske tipke
Ugotovi, na kateri gumb miške se nanaša dogodek in ali so bile aktivne tipke Ctrl, Meta, Shift ali Alt. Loči kodo `button` od bitne maske `buttons`.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey in altKey so lastnosti primerka MouseEvent, namenjene samo branju. Prebereš jih iz objekta dogodka, na primer z event.button. So del spletnega API-ja, ne ECMAScripta 2024, zato je njihova razpoložljivost odvisna od izvajalnega okolja.
Pri dogodkih pritiska ali sprostitve gumba, kot sta mousedown in mouseup, button vsebuje kodo enega gumba: 0 glavni (običajno levi), 1 pomožni (običajno srednji), 2 sekundarni (običajno desni), 3 četrti (navadno Nazaj), 4 peti (navadno Naprej). To so vloge, ne fizični položaji. Pri mousemove vrednost button ni zanesljiv pokazatelj, ali je gumb pritisnjen. buttons je bitna maska pritisnjenih gumbov: 0 pomeni nobenega, 1, 2, 4, 8, 16 pa po vrsti pomenijo glavnega, sekundarnega, pomožnega, četrtega in petega. (event.buttons & 1) !== 0 preveri bit glavnega gumba.
ctrlKey označuje Ctrl, metaKey označuje Meta (Command v macOS, tipka Windows v sistemu Windows), shiftKey označuje Shift, altKey pa Alt (Option v macOS). Vsaka vrednost je true, če dogodek sporoči, da je bila tipka pritisnjena, sicer false. To je stanje, zabeleženo v dogodku, ne sprotno odčitavanje tipkovnice. Operacijski sistem lahko prestreže gesto: v macOS lahko Ctrl+klik odpre kontekstni meni, namesto da bi sprožil običajni click. Sam click ne dokazuje uporabe miške: sprožita ga lahko tudi tipkovnica ali dotik.
V new MouseEvent(type, options) imata izpuščeni možnosti button in buttons privzeto vrednost 0, izpuščene možnosti za modifikacijske tipke pa false. Sintetični dogodek ima isTrusted === false in ne zagotovi uporabniške aktivacije, ki jo zahtevajo nekateri API-ji.
Primeri
// 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}Zaženi kodo v konzoli brskalnika. V prvi vrstici `button: 1` označuje pomožni gumb, `buttons: 6` pa združuje bita sekundarnega (`2`) in pomožnega (`4`) gumba. V drugi vrstici je `button: 0` privzeta vrednost, maska pa označuje le sekundarni gumb. Noben dogodek ni odposlan.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredna · Različica: 4
- JavaScript · Lekcija 38 · Napredna · Različica: 4
- JavaScript · Lekcija 36 · Srednja · Različica: 3
- JavaScript · Lekcija 37 · Srednja · Različica: 3
Viri
- 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