CKTIS / JavaScript
MouseEvent: tlačítka myši a modifikační klávesy
Zjistěte, kterého tlačítka myši se událost týká a zda byly aktivní klávesy Ctrl, Meta, Shift nebo Alt. Rozlišujte kód `button` a bitovou masku `buttons`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey a altKey jsou vlastnosti instance MouseEvent určené pouze ke čtení. Čtou se z objektu události, například pomocí event.button. Patří do webového API, nikoli do ECMAScriptu 2024, takže jejich dostupnost závisí na běhovém prostředí.
U událostí stisku nebo uvolnění, jako jsou mousedown a mouseup, obsahuje button kód jednoho tlačítka: 0 hlavní (obvykle levé), 1 pomocné (obvykle prostřední), 2 sekundární (obvykle pravé), 3 čtvrté (zpravidla Zpět), 4 páté (zpravidla Vpřed). Jde o role, ne o fyzické umístění. U mousemove nelze z button spolehlivě poznat, zda je tlačítko stisknuté. buttons je bitová maska stisknutých tlačítek: 0 znamená žádné, hodnoty 1, 2, 4, 8, 16 označují postupně hlavní, sekundární, pomocné, čtvrté a páté tlačítko. (event.buttons & 1) !== 0 testuje bit hlavního tlačítka.
ctrlKey odpovídá klávese Ctrl, metaKey klávese Meta (Command v macOS, klávesa Windows ve Windows), shiftKey klávese Shift a altKey klávese Alt (Option v macOS). Každá hodnota je true, pokud událost hlásí stisknutou klávesu, jinak false. Jde o stav zaznamenaný v události, nikoli o živé čtení klávesnice. Operační systém může gesto zachytit: v macOS může Ctrl+kliknutí otevřít kontextovou nabídku namísto běžné události click. Samotné click nedokazuje použití myši: může vzniknout i použitím klávesnice nebo dotykem.
V new MouseEvent(type, options) mají vynechané volby button a buttons výchozí hodnotu 0, vynechané volby modifikátorů false. Syntetická událost má isTrusted === false a nezajišťuje aktivaci uživatelem, kterou vyžadují některá API.
Pří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ýsledek
{"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}Spusťte kód v konzoli prohlížeče. Na prvním řádku `button: 1` označuje pomocné tlačítko a `buttons: 6` kombinuje bity sekundárního (`2`) a pomocného (`4`) tlačítka. Na druhém řádku je `button: 0` výchozí hodnota, zatímco maska označuje jen sekundární tlačítko. Ani jedna událost se neodesílá.
Související lekce
- JavaScript · Lekce 37 · Pokročilá · Verze: 4
- JavaScript · Lekce 38 · Pokročilá · Verze: 4
- JavaScript · Lekce 36 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 37 · Středně pokročilá · Verze: 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