CKTIS / JavaScript
MouseEvent: код на бутона и координати във видимата област
Използвай `button`, за да разбереш кой бутон на мишката е натиснат или отпуснат, а `clientX` и `clientY` — за позицията на събитието във видимата област.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
event.button
event.clientX
event.clientY
new MouseEvent(type, { button, buttons, clientX, clientY })button, clientX и clientY са свойства на екземпляр на MouseEvent и са само за четене. В обработчик на събитие чети event.button, а не MouseEvent.button. MouseEvent е уеб API, а не част от ECMAScript 2024. Ако средата не предоставя конструктора и името не е дефинирано, new MouseEvent(...) хвърля грешка ReferenceError.
При събития като mousedown и mouseup свойството button показва кой бутон е натиснат или отпуснат: 0 основен (обикновено ляв), 1 спомагателен (обикновено среден), 2 вторичен (обикновено десен), 3 четвърти (обикновено Назад), 4 пети (обикновено Напред). Това са логически роли, а не фиксирани физически позиции. При mousemove изразът button === 0 не доказва, че основният бутон е задържан. Използвай битовата маска buttons: 0 означава, че няма задържани бутони, а (event.buttons & 1) !== 0 проверява основния бутон.
clientX и clientY са съответно хоризонталната и вертикалната координата на събитието в CSS пиксели. Горният ляв ъгъл на видимата област (viewport) е (0, 0); X нараства надясно, а Y — надолу. Превъртането не мести това начало, но координатите на същата точка в документа могат да са различни при следващо събитие. pageX и pageY са спрямо документа, а screenX и screenY — спрямо екрана. Координатите във видимата област не са спрямо целевия елемент.
С new MouseEvent(type, options) задаваш началните стойности на синтетично събитие. Създаването на обекта не изпраща събитието и не мести показалеца. Събитието има isTrusted === false и не води до потребителска активация.
Примери
<!doctype html>
<meta charset="utf-8">
<title>MouseEvent example</title>
<pre id="output"></pre>
<script>
{
const event = new MouseEvent("mouseup", {
button: 2,
buttons: 0,
clientX: 120,
clientY: 45,
});
document.getElementById("output").textContent =
`button=${event.button}, buttons=${event.buttons}, clientX=${event.clientX}, clientY=${event.clientY}`;
}
</script>Резултат
button=2, buttons=0, clientX=120, clientY=45
Запази примера като HTML файл и го отвори в браузър. Синтетичното събитие `mouseup` описва отпускане на вторичния бутон в точката `(120, 45)`; `buttons=0` означава, че няма останали задържани бутони. Не е нужно да щракваш.
Свързани уроци
- JavaScript · Урок 35 · Средно · Версия: 3