Releases (stops) pointer capture that was previously set for a specific (PointerEvent) pointer.
See the Element.setPointerCapture() method for a description of pointer capture and how to set it for a particular element.
Syntax
targetElement.releasePointerCapture(pointerId);
Arguments
- pointerId
- The
identifierfor apointer event.
Return value
If pointerId does not match any the active pointers, this method returns void and throws a DOMException with the name InvalidPointerId.
Example
<html>
<script>
function downHandler(ev) {
var el=document.getElementById("target");
// Element "target" will receive/capture further events
el.setPointerCapture(ev.pointerId);
}
function cancelHandler(ev) {
var el=document.getElementById("target");
// Release the pointer capture
el.releasePointerCapture(ev.pointerId);
}
function init() {
var el=document.getElementById("target");
// Register pointerdown and pointercancel handlers
el.onpointerdown = downHandler;
el.onpointercancel = cancelHandler;
}
</script>
<body onload="init();">
<div id="target"> Touch me ... </div>
</body>
</html>
Specifications
| Specification | Status | Comment |
|---|---|---|
| Pointer Events – Level 2 The definition of 'releasePointerCapture' in that specification. |
Working Draft | Non-stable version. |
| Pointer Events The definition of 'releasePointerCapture' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | No support | (Yes) | (Yes) [1] | 10 | No support | No support |
| Feature | Android | Android Webview | Chrome for Android | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|---|---|
| Basic support | No support | No support | No support | (Yes) | No support | No support | 10 | No support | No support |
[1] Implementation withdrawn. See bug 1166347.