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.altKeyMouseEvent е интерфейс от 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}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.