KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

PointerEvent: aanwijzer-ID en viewportcoördinaten

Met `pointerId` houd je gelijktijdig actieve aanwijzers uit elkaar. `clientX` en `clientY` geven de positie van de gebeurtenis in de viewport in CSS-pixels.

Versie: Current web platform; runtime support varies

Syntax

event.pointerId
 event.clientX
 event.clientY

pointerId, clientX en clientY zijn alleen-lezen-eigenschappen van een PointerEvent-instantie. pointerId is een numerieke ID die een aanwijzer onderscheidt van andere gelijktijdig actieve aanwijzers, zoals twee vingers op een scherm. Een ID kan na afloop van een interactie opnieuw worden gebruikt. Gebruik deze niet als permanente apparaat-ID en leid er het apparaattype niet uit af. Bij gebeurtenissen die de browser genereert, betekent -1 dat er geen aanwijsapparaat aan te pas kwam, bijvoorbeeld als iemand een knop met het toetsenbord activeert.

clientX (horizontaal) en clientY (verticaal) worden geërfd van MouseEvent, ook bij invoer met aanraking of pen. Ze geven de positie van de gebeurtenis in CSS-pixels vanaf de linkerbovenhoek van de viewport en nemen respectievelijk naar rechts en naar beneden toe. Anders dan pageX en pageY zijn ze niet relatief aan het document. Ze zijn ook niet relatief aan het doelelement of het scherm. Scrollen verandert de viewportcoördinaten van een vast punt in het document, maar niet de oorsprong van de viewport.

Om meerdere interacties te volgen, sla je bij pointerdown de beginpositie op in een Map met pointerId als sleutel. Zoek bij pointermove die sleutel op en negeer de gebeurtenis als er geen item is. Verwijder het item zowel bij pointerup als bij pointercancel. PointerEvent en de van MouseEvent geërfde coördinaateigenschappen behoren tot de API’s van het webplatform. Noch deze eigenschappen, noch het voorbeeld vereisen ECMAScript 2024. De beschikbaarheid van de API’s hangt af van de uitvoeringsomgeving.

Voorbeelden

(() => {
  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}`);
})();

Resultaat

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

Voer dit uit in Node.js of in een browserconsole. Als `PointerEvent` niet beschikbaar is, stuurt de code gewone `Event`-objecten met de drie velden naar dezelfde listeners. De synthetische gebeurtenissen hebben `isTrusted === false` en verplaatsen geen fysieke aanwijzer. De code toont de verplaatsing vanaf het begin van elke interactie. De beweging van aanwijzer `8` na de annulering wordt genegeerd; `tracked=0` betekent dat er geen items meer zijn.

Gerelateerde lessen

  • JavaScript · Les 35 · Gevorderd · Versie: 4

Bronnen