Element: gotpointercapture event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Pointer Events")}}
The **gotpointercapture** event is fired when an element captures a pointer using [setPointerCapture()](/en-US/docs/Web/API/Element/setPointerCapture).
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("gotpointercapture", (event) => { })Alternatively, assign to the event handler property of the interface:
ongotpointercapture = (event) => { }Event type
A {{domxref("PointerEvent")}}. Inherits from {{domxref("Event")}}.
{{InheritanceDiagram("PointerEvent")}}
Examples
This example gets a <p> element and listens for the gotpointercapture event. It then calls setPointerCapture() on the element on a pointerdown event, which will trigger gotpointercapture.
const para = document.querySelector("p");
para.addEventListener("gotpointercapture", () => {
console.log("I've been captured!");
});
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});The same example, using the ongotpointercapture event handler property (but note that this replaces other event listeners added using ongotpointercapture, if any):
const para = document.querySelector("p");
para.ongotpointercapture = () => {
console.log("I've been captured!");
};
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Related events
- {{domxref('Element/lostpointercapture_event', 'lostpointercapture')}}
- {{domxref('Element/pointerover_event', 'pointerover')}}
- {{domxref('Element/pointerenter_event', 'pointerenter')}}
- {{domxref('Element/pointerdown_event', 'pointerdown')}}
- {{domxref('Element/pointermove_event', 'pointermove')}}
- {{domxref('Element/pointerup_event', 'pointerup')}}
- {{domxref('Element/pointercancel_event', 'pointercancel')}}
- {{domxref('Element/pointerout_event', 'pointerout')}}
- {{domxref('Element/pointerleave_event', 'pointerleave')}}
- {{domxref('Element/pointerrawupdate_event', 'pointerrawupdate')}}