Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

PointerEvent : identifiant et pointeur principal

`pointerId` relie les événements d’un même pointeur actif ; `isPrimary` indique si ce pointeur est principal pour son type d’entrée.

Version : Current web platform; runtime support varies

Syntaxe

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

pointerId est un identifiant numérique en lecture seule. Il permet d’associer les événements d’un même pointeur actif et de le distinguer des autres pointeurs actifs, par exemple d’un deuxième point de contact. Ce n’est pas un identifiant permanent d’appareil : ne déduisez pas le type d’appareil du nombre et ne supposez ni qu’il restera identique d’une interaction à l’autre ni qu’il ne sera jamais réutilisé. Dans un événement généré par le navigateur, -1 signifie qu’aucun dispositif de pointage n’est à l’origine de l’événement, comme pour un click déclenché au clavier.

isPrimary est une propriété booléenne en lecture seule. true désigne le pointeur principal pour le pointerType concerné, pas le bouton principal. Le pointeur de la souris est principal ; pour le tactile et le stylet, c’est le premier pointeur du type concerné à devenir actif alors qu’aucun autre du même type n’est actif. Une souris et un contact tactile peuvent donc avoir simultanément isPrimary === true. Quand le contact tactile principal prend fin, un contact encore actif ne devient pas automatiquement principal.

Pour suivre plusieurs gestes, enregistrez l’état dans une Map indexée par pointerId lors de pointerdown, consultez-le lors de pointermove et supprimez-le lors de pointerup ou pointercancel. Si vous ne voulez qu’un seul pointeur tous types confondus, mémorisez l’identifiant sélectionné : filtrer sur isPrimary ne suffit pas. Ces propriétés relèvent d’une API web, pas d’ECMAScript ; vérifiez leur prise en charge dans l’environnement cible.

Exemples

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

Résultat

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

Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur qui prend en charge `PointerEvent`. Le résultat s’affiche sur la page. L’identifiant `7` relie deux événements tactiles, `8` désigne un autre contact, et la souris comme le premier contact ont la valeur `true`. Le code lit des valeurs fournies explicitement à des événements synthétiques. Il ne les distribue pas et ne teste pas comment le navigateur attribue les valeurs lors d’une entrée réelle.

Leçons associées

  • JavaScript · Leçon 35 · Intermédiaire · Version : 3

Sources