Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

PointerEvent: identificador del puntero y coordenadas del área de visualización

`pointerId` distingue los punteros activos al mismo tiempo; `clientX` y `clientY` sitúan el evento en el área de visualización en píxeles CSS.

Versión: Current web platform; runtime support varies

Sintaxis

event.pointerId
 event.clientX
 event.clientY

pointerId, clientX y clientY son propiedades de solo lectura de una instancia de PointerEvent. pointerId es un identificador numérico que distingue un puntero de los demás punteros activos al mismo tiempo, como dos dedos sobre la pantalla. Un identificador puede reutilizarse cuando termina una interacción. No lo uses como identificador permanente del dispositivo ni deduzcas de él el tipo de dispositivo. En eventos generados por el navegador, -1 indica que el evento no procede de un dispositivo apuntador, como al activar un botón con el teclado.

clientX (horizontal) y clientY (vertical) se heredan de MouseEvent, incluso para entradas táctiles o con lápiz. Ubican el evento en píxeles CSS desde la esquina superior izquierda del área de visualización (viewport) y aumentan hacia la derecha y hacia abajo, respectivamente. A diferencia de pageX y pageY, no son relativas al documento. Tampoco son relativas al elemento de destino ni a la pantalla. Al desplazar el documento cambian las coordenadas de un punto fijo del documento en el área de visualización, pero no el origen de esa área.

Para seguir varias interacciones, en pointerdown guarda cada posición inicial en un Map con pointerId como clave. En pointermove, busca esa clave e ignora el evento si no hay ninguna entrada. Borra la entrada tanto en pointerup como en pointercancel. PointerEvent y las propiedades de coordenadas heredadas de MouseEvent pertenecen a las API de la plataforma web. Ni estas propiedades ni el ejemplo requieren ECMAScript 2024. La disponibilidad de estas API depende del entorno de ejecución.

Ejemplos

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

Resultado

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

Ejecuta el código en Node.js o en la consola de un navegador. Si `PointerEvent` no está disponible, el código envía objetos `Event` simples con los tres campos a los mismos manejadores. Los eventos sintéticos tienen `isTrusted === false` y no mueven un puntero físico. El código muestra el desplazamiento desde el inicio de cada interacción. El movimiento del puntero `8` tras la cancelación se ignora; `tracked=0` indica que no queda ninguna entrada.

Lecciones relacionadas

  • JavaScript · Lección 35 · Avanzado · Versión: 4

Fuentes