Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MouseEvent: koda gumba in koordinate vidnega območja

Z `button` ugotoviš, kateri gumb miške je bil pritisnjen ali spuščen, z `clientX` in `clientY` pa prebereš položaj dogodka v vidnem območju.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

event.button
 event.clientX
 event.clientY

new MouseEvent(type, { button, buttons, clientX, clientY })

button, clientX in clientY so lastnosti primerka MouseEvent samo za branje. V obravnavalniku dogodka beri event.button, ne MouseEvent.button. MouseEvent je spletni API in ni del ECMAScripta 2024. Če okolje ne ponuja konstruktorja in ime ni definirano, new MouseEvent(...) sproži napako ReferenceError.

Pri dogodkih, kot sta mousedown in mouseup, button pove, kateri gumb je bil pritisnjen ali spuščen: 0 primarni (običajno levi), 1 pomožni (običajno srednji), 2 sekundarni (običajno desni), 3 četrti (običajno Nazaj), 4 peti (običajno Naprej). To so logične vloge, ne stalni fizični položaji. Pri mousemove izraz button === 0 ne dokazuje, da je primarni gumb pritisnjen. Uporabi bitno masko buttons: 0 pomeni, da ni pritisnjen noben gumb, izraz (event.buttons & 1) !== 0 pa preveri primarni gumb.

clientX in clientY sta vodoravna in navpična koordinata dogodka v slikovnih pikah CSS. Zgornji levi kot vidnega območja (viewporta) je (0, 0); X narašča v desno, Y pa navzdol. Drsenje ne premakne tega izhodišča, vendar se lahko koordinate iste točke dokumenta pri poznejšem dogodku spremenijo. pageX in pageY se nanašata na dokument, screenX in screenY pa na zaslon. Koordinate vidnega območja niso podane glede na ciljni element.

Z new MouseEvent(type, options) nastaviš začetne vrednosti sintetičnega dogodka. Ustvarjanje objekta dogodka ne razpošlje in ne premakne kazalca. Dogodek ima isTrusted === false in ne sproži uporabniške aktivacije.

Primeri

<!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>

Rezultat

button=2, buttons=0, clientX=120, clientY=45

Shrani primer kot datoteko HTML in jo odpri v brskalniku. Sintetični `mouseup` opisuje spust sekundarnega gumba v točki `(120, 45)`; `buttons=0` pomeni, da noben gumb ne ostane pritisnjen. Klik ni potreben.

Povezane lekcije

  • JavaScript · Lekcija 35 · Srednja · Različica: 3

Viri