Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

PointerEvent: identifikator pokazivača i koordinate prikaznog područja

`pointerId` razlikuje istodobno aktivne pokazivače, a `clientX` i `clientY` određuju položaj događaja u prikaznom području u CSS pikselima.

Verzija: Current web platform; runtime support varies

Sintaksa

event.pointerId
 event.clientX
 event.clientY

pointerId, clientX i clientY svojstva su instance PointerEvent dostupna samo za čitanje. pointerId je brojčani identifikator koji razlikuje pokazivač od ostalih istodobno aktivnih pokazivača, primjerice pri dodiru zaslona dvama prstima. Identifikator se može ponovno upotrijebiti nakon završetka interakcije. Ne koristi ga kao trajni identifikator uređaja i nemoj iz njega zaključivati o vrsti uređaja. U događaju koji je stvorio preglednik -1 znači da ga nije izazvao pokazivački uređaj, primjerice kad je gumb aktiviran tipkovnicom.

clientX (vodoravna) i clientY (okomita) nasljeđuju se iz MouseEvent, čak i pri unosu dodirom ili olovkom. Određuju položaj događaja u CSS pikselima od gornjeg lijevog kuta prikaznog područja (viewporta) i rastu udesno odnosno prema dolje. Za razliku od pageX i pageY, ne odnose se na dokument. Ne odnose se ni na ciljni element ni na zaslon. Pomicanje dokumenta mijenja koordinate njegove nepomične točke u prikaznom području, ali ne i ishodište tog područja.

Za praćenje više interakcija na pointerdown spremi početni položaj u Map s ključem pointerId. Na pointermove potraži taj ključ i zanemari događaj ako nema zapisa. Ukloni zapis i na pointerup i na pointercancel. PointerEvent i svojstva koordinata naslijeđena iz MouseEvent pripadaju API-jima web-platforme. Ni ta svojstva ni primjer ne zahtijevaju ECMAScript 2024. Dostupnost API-ja ovisi o okruženju izvršavanja.

Primjeri

(() => {
  const target = new EventTarget();
  const starts = new Map();

  target.addEventListener("pointerdown", ({ pointerId, clientX, clientY }) => {
    starts.set(pointerId, { x: clientX, y: clientY });
  });
  target.addEventListener("pointermove", ({ pointerId, clientX, clientY }) => {
    const start = starts.get(pointerId);
    if (!start) return;
    console.log(`${pointerId}: dx=${clientX - start.x}, dy=${clientY - start.y}`);
  });
  const end = ({ pointerId }) => { starts.delete(pointerId); };
  target.addEventListener("pointerup", end);
  target.addEventListener("pointercancel", end);

  const send = (type, pointerId, clientX, clientY) => {
    const fields = { pointerId, clientX, clientY };
    // Without PointerEvent, use a plain Event to exercise the same listeners.
    const event = typeof PointerEvent === "function"
      ? new PointerEvent(type, fields)
      : Object.assign(new Event(type), fields);
    target.dispatchEvent(event);
  };

  send("pointerdown", 7, 100, 80);
  send("pointerdown", 8, 200, 150);
  send("pointermove", 7, 112, 75);
  send("pointermove", 8, 197, 159);
  send("pointercancel", 8, 197, 159);
  send("pointermove", 8, 198, 160);
  send("pointerup", 7, 112, 75);
  console.log(`tracked=${starts.size}`);
})();

Rezultat

7: dx=12, dy=-5
8: dx=-3, dy=9
tracked=0

Pokreni kôd u Node.js-u ili u konzoli preglednika. Ako `PointerEvent` nije dostupan, kôd istim rukovateljima šalje obične objekte `Event` s trima poljima. Sintetički događaji imaju `isTrusted === false` i ne pomiču stvarni pokazivač. Kôd ispisuje pomak od početka svake interakcije. Pomak pokazivača `8` nakon otkazivanja zanemaruje se; `tracked=0` znači da nema preostalih zapisa.

Povezane lekcije

  • JavaScript · Lekcija 35 · Napredno · Verzija: 4

Izvori