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 : évènement gotpointercapture

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.

L'évènement gotpointercapture est déclenché lorsqu'un élément capture un pointeur en utilisant setPointerCapture().

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.

js
addEventListener("gotpointercapture", (event) => { })

ongotpointercapture = (event) => { }

Type d'évènement

Un objet PointerEvent. Hérite de Event.

Event UIEvent MouseEvent PointerEvent

Exemples

Cet exemple obtient un élément <p> et écoute l'évènement gotpointercapture. Il appelle ensuite setPointerCapture() sur l'élément lors d'un évènement pointerdown, ce qui déclenche gotpointercapture.

js
const para = document.querySelector("p");

para.addEventListener("gotpointercapture", () => {
  console.log("J'ai été capturé !");
});

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Le même exemple, utilisant la propriété de gestionnaire d'évènement ongotpointercapture :

js
const para = document.querySelector("p");

para.ongotpointercapture = () => {
  console.log("J'ai été capturé !");
};

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Spécifications

Spécification
Pointer Events
# the-gotpointercapture-event
Pointer Events
# dom-globaleventhandlers-ongotpointercapture

Compatibilité des navigateurs

Voir aussi