База знанияИзпитен център
BGБългарски
Избери език13

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.altKey

button, 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

Източници