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

CKTIS / JavaScript

MouseEvent: бутон, координати и модификаторни клавиши

Полетата на MouseEvent показват бутона, свързан със събитието, координатите на показалеца спрямо областта за визуализация и състоянието на Ctrl, Meta, Shift и Alt. Разграничавайте button от buttons, както и координатите на областта за визуализация от координатите на документа.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent е интерфейс от Web API на браузъра, а не част от самия ECMAScript. Свойствата на неговите екземпляри са само за четене. В обработчик на събитие ги прочетете от получения обект, например event.clientX; MouseEvent.clientX е запис, използван в документацията, а не достъп до статично свойство.

MouseEvent.button определя бутона, който е натиснат или освободен: 0 — основен, 1 — спомагателен, 2 — вторичен, 3 — обикновено Назад, 4 — обикновено Напред. Основният бутон не е задължително физически левият, тъй като потребителят може да промени настройките. 0 може да означава и неинициализирано състояние. Не използвайте button, за да определяте кои бутони се задържат при mousemove; за това служи битовата маска buttons.

MouseEvent.clientX и MouseEvent.clientY дават съответно хоризонталната и вертикалната координата в пиксели спрямо областта за визуализация (viewport), а не спрямо елемента или целия документ. Левият и горният ръб на областта за визуализация съответстват на стойността 0, дори след превъртане на документа. Не приемайте, че координатите непременно са цели числа.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey и MouseEvent.altKey са булеви стойности, описващи съответно състоянието на Ctrl, Meta, Shift и Alt в момента на събитието. Meta е Command в macOS и клавишът Windows на клавиатурите за Windows. Операционната система може да прихване Meta. В macOS Ctrl-клик отваря контекстно меню, затова ctrlKey не може да бъде установен в това събитие click.

Тези полета и конструкторът се поддържат широко от браузърите; наличието на Node 24 в хранилище не доказва поддръжка на API за браузър. Примерът създава синтетично събитие mousedown с фиксирани данни: не премества показалеца и не изпраща събитието към елемент.

Примери

const event = new MouseEvent("mousedown", {
  button: 0,
  clientX: 120,
  clientY: 80,
  ctrlKey: true,
  metaKey: false,
  shiftKey: true,
  altKey: false
});

console.log(JSON.stringify({
  button: event.button,
  x: event.clientX,
  y: event.clientY,
  ctrl: event.ctrlKey,
  meta: event.metaKey,
  shift: event.shiftKey,
  alt: event.altKey
}));

Резултат

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници