Element: releasePointerCapture() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **releasePointerCapture()** method of the {{domxref("Element")}} interface releases (stops) _pointer capture_ that was previously set for a specific ({{domxref("PointerEvent")}}) _pointer_.
Syntax
js-nolint
releasePointerCapture(pointerId)Parameters
pointerId- : The {{domxref("PointerEvent.pointerId", "pointerId")}} of a
{{domxref("PointerEvent")}} object.
Return value
None ({{jsxref("undefined")}}).
Exceptions
NotFoundError{{domxref("DOMException")}}- : Thrown if
pointerIddoes not match any active pointer.
Examples
This example sets pointer capture on a {{HtmlElement("div")}} when you press down on it. This lets you slide the element horizontally, even when your pointer moves outside of its boundaries.
HTML
html
<div id="slider">SLIDE ME</div>CSS
css
div {
width: 140px;
height: 50px;
display: flex;
align-items: center;
justify-content: center;
background: #ffbbee;
}JavaScript
js
const slider = document.getElementById("slider");
function beginSliding(e) {
slider.onpointermove = slide;
slider.setPointerCapture(e.pointerId);
}
function stopSliding(e) {
slider.onpointermove = null;
slider.releasePointerCapture(e.pointerId);
}
function slide(e) {
slider.style.transform = `translate(${e.clientX - 70}px)`;
}
slider.onpointerdown = beginSliding;
slider.onpointerup = stopSliding;Result
{{EmbedLiveSample("Examples")}}
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{ domxref("Element.hasPointerCapture","Element.hasPointerCapture()") }}
- {{ domxref("Element.setPointerCapture","Element.setPointerCapture()") }}
- Pointer events