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

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

Източници