Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element : méthode hasPointerCapture()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2020.

La méthode hasPointerCapture() de l'interface Element vérifie si l'élément sur lequel elle est invoquée a la capture du pointeur pour le pointeur identifié par l'ID de pointeur donné.

Syntaxe

js
hasPointerCapture(pointerId)

Paramètres

pointerId

Le pointerId d'un objet PointerEvent.

Valeur de retour

Un booléen — true si l'élément a la capture du pointeur pour le pointeur identifié par l'ID de pointeur donné, false sinon.

Exemples

html
<div id="cible">Touchez cet élément avec un pointeur.</div>
js
const el = document.getElementById("cible");
el.addEventListener("pointerdown", (ev) => {
  // L'élément 'cible' reçoit/capture les évènements suivants
  el.setPointerCapture(ev.pointerId);

  // …

  // Vérifie si l'élément a toujours la capture du pointeur
  const pointerCap = el.hasPointerCapture(ev.pointerId);
  if (pointerCap) {
    // Nous avons toujours la capture du pointeur
  } else {
    // Oups, nous avons perdu la capture du pointeur !
  }
});

Spécifications

Spécification
Pointer Events
# dom-element-haspointercapture

Compatibilité des navigateurs

Voir aussi