Element.setCapture()

在此页

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

非标
此特征是非标准的，且不在标准轨道中。不要在面向 Web 的生产站点中使用它：它不适用于每个用户。实现之间可能存在大的不兼容性，且行为将来可能改变。

Call this method during the handling of a mousedown event to retarget all mouse events to this element until the mouse button is released or document.releaseCapture() 被调用。

警告： This interface never had much cross-browser support and you probably looking for


								element.setPointerCapture

instead, from the Pointer Events API.

句法

element.setCapture(retargetToElement);

retargetToElement: 若 true , all events are targeted directly to this element; if false , events can also fire at descendants of this element.

范例

In this example, the current mouse coordinates are drawn while you mouse around after clicking and holding down on an element.

<html>
<head>
  <title>Mouse Capture Example</title>
  <style type="text/css">
    #myButton {
      border: solid black 1px;
      color: black;
      padding: 2px;
      box-shadow: black 2px 2px;
    }
  </style>
  <script type="text/javascript">
    function init() {
      var btn = document.getElementById("myButton");
      if (btn.setCapture) {
        btn.addEventListener("mousedown", mouseDown, false);
        btn.addEventListener("mouseup", mouseUp, false);
      } else {
        document.getElementById("output").innerHTML
          = "Sorry, there appears to be no setCapture support on this browser";
      }
    }
    function mouseDown(e) {
      e.target.setCapture();
      e.target.addEventListener("mousemove", mouseMoved, false);
    }
    function mouseUp(e) {
      e.target.removeEventListener("mousemove", mouseMoved, false);
    }
    function mouseMoved(e) {
      var output = document.getElementById("output");
      output.innerHTML = "Position: " + e.clientX + ", " + e.clientY;
    }
  </script>
</head>
<body onload="init()">
  <p>This is an example of how to use mouse capture on elements in Gecko 2.0.</p>
  <p><a id="myButton" href="#">Test Me</a></p>
  <div id="output">No events yet</div>
</body>
</html>

View Live Examples

注意事项

The element may not be scrolled completely to the top or bottom, depending on the layout of other elements.

规范

Based on Internet Explorer's implementation.

浏览器兼容性

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
`setCapture` 弃用非标	Chrome No	Edge 12 — 79 不支持 12 — 79 `retargetToElement` 参数用于 `Element.setCapture()` was introduced in Edge 5.5.	Firefox Yes	IE 5 5 `retargetToElement` 参数用于 `Element.setCapture()` was introduced in Internet Explorer 5.5.	Opera No	Safari ?	WebView Android No	Chrome Android No	Firefox Android ?	Opera Android No	Safari iOS ?	Samsung Internet Android No

图例

完整支持
不支持
兼容性未知 ?
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。

另请参阅

元数据

最后修改： 2019 年 3 月 23 日

在此页

句法

范例

注意事项

规范

浏览器兼容性

图例

另请参阅

相关话题