CKTIS / JavaScript
MouseEvent: бутони на мишката и модифициращи клавиши
Разбери за кой бутон на мишката се отнася събитието и дали Ctrl, Meta, Shift или Alt са били активни. Разграничавай кода `button` от битовата маска `buttons`.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
event.button
event.ctrlKey
event.metaKey
event.shiftKey
event.altKeybutton, ctrlKey, metaKey, shiftKey и altKey са свойства само за четене на екземпляр на MouseEvent. Чети ги от обекта на събитието, например с event.button. Те са част от уеб API, а не от ECMAScript 2024, затова наличността им зависи от средата за изпълнение.
При събития за натискане или отпускане, като mousedown и mouseup, button съдържа код за един бутон: 0 основен (обикновено ляв), 1 спомагателен (обикновено среден), 2 вторичен (обикновено десен), 3 четвърти (обикновено Назад), 4 пети (обикновено Напред). Това са роли, а не физически позиции. При mousemove стойността на button не показва надеждно дали има задържан бутон. buttons е битова маска на задържаните бутони: 0 означава нито един, а 1, 2, 4, 8, 16 означават съответно основния, вторичния, спомагателния, четвъртия и петия бутон. (event.buttons & 1) !== 0 проверява бита на основния бутон.
ctrlKey отговаря на Ctrl, metaKey — на Meta (Command в macOS, клавишът Windows в Windows), shiftKey — на Shift, а altKey — на Alt (Option в macOS). Всяка стойност е true, ако събитието отчита клавиша като натиснат, и false в противен случай. Това е състоянието, записано в събитието, а не текущо отчитане на клавиатурата. Операционната система може да прихване жест: в macOS Ctrl+щракване може да отвори контекстно меню вместо да предизвика обикновено събитие click. Само по click не може да се заключи, че е използвана мишка: събитието може да възникне и при използване на клавиатура или при докосване.
В new MouseEvent(type, options) пропуснатите опции button и buttons имат стойност по подразбиране 0, а пропуснатите опции за модифициращите клавиши — false. Синтетичното събитие има isTrusted === false и не осигурява потребителската активация, изисквана от някои API.
Примери
// 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 }));
}Резултат
{"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}Изпълни кода в конзолата на браузъра. На първия ред `button: 1` обозначава спомагателния бутон, а `buttons: 6` съчетава битовете за вторичния (`2`) и спомагателния (`4`) бутон. На втория ред `button: 0` е стойността по подразбиране, а маската показва само вторичния бутон. Нито едно събитие не се изпраща.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4
- JavaScript · Урок 38 · Напреднало · Версия: 4
- JavaScript · Урок 36 · Средно · Версия: 3
- JavaScript · Урок 37 · Средно · Версия: 3
Източници
- 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