WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

PointerEvent: Zeiger-ID und Viewport-Koordinaten

Mit `pointerId` unterscheidest du gleichzeitig aktive Zeiger. `clientX` und `clientY` geben die Position des Ereignisses im Viewport in CSS-Pixeln an.

Version: Current web platform; runtime support varies

Syntax

event.pointerId
 event.clientX
 event.clientY

pointerId, clientX und clientY sind schreibgeschützte Eigenschaften einer PointerEvent-Instanz. pointerId ist eine numerische Kennung, die gleichzeitig aktive Zeiger unterscheidet, etwa zwei Finger auf einem Bildschirm. Nach dem Ende einer Interaktion kann die Kennung erneut vergeben werden. Verwende sie weder als dauerhafte Gerätekennung noch zur Bestimmung des Gerätetyps. Bei vom Browser erzeugten Ereignissen bedeutet -1, dass kein Zeigegerät das Ereignis ausgelöst hat, etwa wenn eine Schaltfläche per Tastatur aktiviert wird.

clientX (horizontal) und clientY (vertikal) werden von MouseEvent geerbt, auch bei Touch- und Stifteingaben. Sie geben die Position des Ereignisses in CSS-Pixeln ab der linken oberen Ecke des Viewports an und nehmen nach rechts bzw. nach unten zu. Anders als pageX und pageY beziehen sie sich nicht auf das Dokument. Sie beziehen sich auch nicht auf das Zielelement oder den Bildschirm. Scrollen ändert die Viewport-Koordinaten eines festen Punkts im Dokument, nicht aber den Ursprung des Viewports.

Um mehrere Interaktionen zu verfolgen, speichere bei pointerdown die Startposition in einer Map mit pointerId als Schlüssel. Suche bei pointermove nach diesem Schlüssel und ignoriere das Ereignis, wenn kein Eintrag existiert. Lösche den Eintrag sowohl bei pointerup als auch bei pointercancel. PointerEvent und die von MouseEvent geerbten Koordinateneigenschaften gehören zu den Web-APIs. Weder diese Eigenschaften noch das Beispiel setzen ECMAScript 2024 voraus. Die Verfügbarkeit der APIs hängt von der Laufzeitumgebung ab.

Beispiele

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

Ergebnis

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

Führe den Code in Node.js oder in einer Browserkonsole aus. Wenn `PointerEvent` nicht verfügbar ist, löst der Code dieselben Listener mit einfachen `Event`-Objekten aus, die die drei Felder enthalten. Die synthetischen Ereignisse haben `isTrusted === false` und bewegen keinen physischen Zeiger. Der Code gibt die Verschiebung seit Beginn der jeweiligen Interaktion aus. Die Bewegung von Zeiger `8` nach dem Abbruch wird ignoriert; `tracked=0` bedeutet, dass keine Einträge übrig sind.

Zugehörige Lektionen

  • JavaScript · Lektion 35 · Fortgeschritten · Version: 4

Quellen