CKTIS / JavaScript
MouseEvent: tlačidlá myši a modifikačné klávesy
Zistite, ktorého tlačidla myši sa udalosť týka a či boli aktívne klávesy Ctrl, Meta, Shift alebo Alt. Rozlišujte kód `button` a bitovú masku `buttons`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey a altKey sú vlastnosti inštancie MouseEvent určené len na čítanie. Čítajú sa z objektu udalosti, napríklad pomocou event.button. Patria do webového API, nie do ECMAScriptu 2024, preto ich dostupnosť závisí od prostredia vykonávania.
Pri udalostiach stlačenia alebo uvoľnenia, napríklad mousedown a mouseup, obsahuje button kód jedného tlačidla: 0 hlavné (zvyčajne ľavé), 1 pomocné (zvyčajne stredné), 2 sekundárne (zvyčajne pravé), 3 štvrté (spravidla Späť), 4 piate (spravidla Dopredu). Tieto kódy označujú roly tlačidiel, nie ich fyzické polohy. Pri mousemove sa z hodnoty button nedá spoľahlivo určiť, či je tlačidlo stlačené. buttons je bitová maska stlačených tlačidiel: 0 znamená žiadne, hodnoty 1, 2, 4, 8, 16 označujú postupne hlavné, sekundárne, pomocné, štvrté a piate tlačidlo. (event.buttons & 1) !== 0 testuje bit hlavného tlačidla.
ctrlKey označuje Ctrl, metaKey označuje Meta (Command v macOS, kláves Windows v systéme Windows), shiftKey označuje Shift a altKey označuje Alt (Option v macOS). Každá hodnota je true, ak udalosť hlási stlačený kláves, inak false. Je to stav zaznamenaný v udalosti, nie čítanie klávesnice v reálnom čase. Operačný systém môže gesto zachytiť: v macOS môže Ctrl+kliknutie otvoriť kontextovú ponuku namiesto bežnej udalosti click. Samotné click nedokazuje použitie myši: môže vzniknúť aj použitím klávesnice alebo dotykom.
V new MouseEvent(type, options) majú vynechané voľby button a buttons predvolenú hodnotu 0 a vynechané voľby modifikátorov false. Syntetická udalosť má isTrusted === false a nezabezpečuje aktiváciu používateľom, ktorú vyžadujú niektoré API.
Príklady
// 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 }));
}Výsledok
{"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}Spustite kód v konzole prehliadača. V prvom riadku `button: 1` označuje pomocné tlačidlo a `buttons: 6` kombinuje bity sekundárneho (`2`) a pomocného (`4`) tlačidla. V druhom riadku je `button: 0` predvolená hodnota, zatiaľ čo maska označuje len sekundárne tlačidlo. Ani jedna udalosť sa neodošle.
Súvisiace lekcie
- JavaScript · Lekcia 37 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 38 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 36 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 37 · Stredne pokročilá · Verzia: 3
Zdroje
- 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