Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

PointerEvent: identificatore e puntatore primario

`pointerId` collega gli eventi dello stesso puntatore attivo; `isPrimary` indica se quel puntatore è primario per il suo tipo di input.

Versione: Current web platform; runtime support varies

Sintassi

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

pointerId è un identificatore numerico di sola lettura. Collega gli eventi dello stesso puntatore attivo e permette di distinguerlo dagli altri puntatori attivi, come un secondo punto di contatto. Non è un identificatore permanente del dispositivo: non dedurre il tipo di dispositivo dal numero e non dare per scontato che rimanga invariato tra interazioni o che non venga mai riutilizzato. Negli eventi generati dal browser, -1 indica che non è intervenuto un dispositivo di puntamento, per esempio in un click attivato da tastiera.

isPrimary è una proprietà booleana di sola lettura. true indica il puntatore primario per quel pointerType, non il pulsante principale. Il puntatore del mouse è primario; per il tocco e la penna, è primario il primo puntatore del tipo in questione a diventare attivo quando nessun altro puntatore dello stesso tipo è attivo. Un mouse e un contatto tattile possono quindi avere entrambi isPrimary === true. Quando termina il contatto tattile primario, un contatto ancora attivo non diventa automaticamente primario.

Per seguire più gesti, salva lo stato in una Map con pointerId come chiave su pointerdown, consultalo su pointermove ed eliminalo su pointerup o pointercancel. Se vuoi un solo puntatore tra tutti i tipi di input, memorizza l’identificatore scelto: filtrare solo per isPrimary non basta. Queste proprietà appartengono a un’API web, non a ECMAScript; verifica il supporto nell’ambiente di destinazione.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML e aprilo in un browser che supporta `PointerEvent`. Il risultato viene mostrato nella pagina. L’identificatore `7` collega due eventi di tocco, `8` indica un altro contatto e sia il mouse sia il primo contatto hanno il valore `true`. Il codice legge valori impostati esplicitamente in eventi sintetici. Non invia gli eventi e non verifica come il browser assegna i valori agli input reali.

Lezioni correlate

  • JavaScript · Lezione 35 · Intermedio · Versione: 3

Fonti