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

CKTIS / JavaScript

PointerEvent: identificador y puntero principal

`pointerId` relaciona los eventos de un mismo puntero activo; `isPrimary` indica si es el puntero principal de su tipo de entrada.

Versión: Current web platform; runtime support varies

Sintaxis

// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId  // number, read-only
event.isPrimary  // boolean, read-only

pointerId es un identificador numérico de solo lectura. Permite relacionar los eventos de un mismo puntero activo y distinguirlo de otros punteros activos, como un segundo punto de contacto. No es un identificador permanente de dispositivo: no deduzcas el tipo de dispositivo a partir del número ni des por hecho que se mantendrá entre interacciones o que nunca se reutilizará. En eventos generados por el navegador, -1 indica que no intervino un dispositivo apuntador, por ejemplo en un click activado con el teclado.

isPrimary es una propiedad booleana de solo lectura. true identifica al puntero principal de ese pointerType, no al botón principal. El puntero del ratón es principal; para el tacto y el lápiz, es principal el primer puntero de ese tipo que se activa cuando no hay otro del mismo tipo activo. Por tanto, un ratón y un contacto táctil pueden tener isPrimary === true a la vez. Al terminar el contacto táctil principal, otro contacto que siga activo no se convierte automáticamente en principal.

Para seguir varios gestos, guarda el estado en un Map con pointerId como clave en pointerdown, consúltalo en pointermove y elimínalo en pointerup o pointercancel. Si solo quieres un puntero entre todos los tipos, guarda el identificador elegido: filtrar solo por isPrimary no basta. Estas propiedades pertenecen a una API web, no a ECMAScript; comprueba la compatibilidad en el entorno de destino.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>PointerEvent example</title>
<pre id="output"></pre>
<script>
  const events = [
    new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 7, isPrimary: true }),
    new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 8, isPrimary: false }),
    new PointerEvent("pointermove", { pointerType: "touch", pointerId: 7, isPrimary: true }),
    new PointerEvent("pointermove", { pointerType: "mouse", pointerId: 12, isPrimary: true }),
  ];

  const lines = [];
  for (const event of events) {
    lines.push(`${event.type} ${event.pointerType} ${event.pointerId} ${event.isPrimary}`);
  }
  document.getElementById("output").textContent = lines.join("\n");
</script>

Resultado

pointerdown touch 7 true
pointerdown touch 8 false
pointermove touch 7 true
pointermove mouse 12 true

Guarda el ejemplo como archivo HTML y ábrelo en un navegador compatible con `PointerEvent`. El resultado aparece en la página. El identificador `7` relaciona dos eventos táctiles, `8` identifica otro contacto y tanto el ratón como el primer contacto tienen el valor `true`. El código lee valores fijados de forma explícita en eventos sintéticos. No despacha los eventos ni comprueba cómo asigna el navegador los valores para entradas reales.

Lecciones relacionadas

  • JavaScript · Lección 35 · Intermedio · Versión: 3

Fuentes