Element.releasePointerCapture()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

releasePointerCapture() 方法在 元素 interface releases (stops) pointer capture that was previously set for a specific ( PointerEvent ) pointer .

见 Element.setPointerCapture() method for a description of pointer capture and how to set it for a particular element.

句法

targetElement.releasePointerCapture(pointerId);

参数

pointerId: pointerId 的 PointerEvent 对象。

返回值

此方法返回 undefined .

异常

异常	解释
`InvalidPointerId`	pointerId does not match any of the active pointers.

范例

This example sets pointer capture on a <div> when you press down on it. This lets you slide the element horizontally, even when you pointer moves outside of its boundaries.

HTML

<div id="slider">SLIDE ME</div>

CSS

div {
  width: 140px;
  height: 50px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: #fbe;
}

JavaScript

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)`;
}
const slider = document.getElementById('slider');
slider.onpointerdown = beginSliding;
slider.onpointerup = stopSliding;

结果

规范

规范	状态	注释
指针事件 – 2 级 The definition of 'releasePointerCapture' in that specification.	推荐	非稳定版本。
指针事件 The definition of 'releasePointerCapture' in that specification.	过时	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`releasePointerCapture`	Chrome 55	Edge 12	Firefox 59 59 Disabled ). To change preferences in Firefox, visit	IE 11 11 10 Prefixed Prefixed Implemented with the vendor prefix: ms	Opera 42	Safari 13	WebView Android 55	Chrome Android 55	Firefox Android No 不支持 No Disabled ). To change preferences in Firefox, visit	Opera Android 42	Safari iOS 13	Samsung Internet Android 6.0

在此页

句法

参数

返回值

异常

范例

HTML

CSS

JavaScript

结果

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题