Элемент: метод setCapture()

Устаревший: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть уже удалена из соответствующих веб-стандартов, находится в процессе удаления или поддерживается только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Нестандартный: Эта функция нестандартна и не соответствует стандартам. Не используйте её на сайтах, работающих в Интернете: она не будет работать для каждого пользователя. Также могут быть значительные различия в реализации, и поведение может измениться в будущем.

Вызовите этот метод во время обработки события mousedown, чтобы перенаправить все события мыши на этот элемент, пока кнопка мыши не будет отпущена или не будет вызван метод document.releaseCapture().

Предупреждение: Этот интерфейс никогда не имел широкой поддержки в разных браузерах, и, вероятно, вам нужен element.setPointerCapture из API событий Pointer Events.

Синтаксис

setCapture(retargetToElement)

Параметры

retargetToElement: Если true, все события направляются непосредственно на этот элемент; если false, события могут также срабатывать на потомках этого элемента.

Возвращаемое значение

None (undefined).

Примеры

В этом примере текущие координаты мыши отображаются, когда вы перемещаете мышь, удерживая нажатой кнопку мыши на элементе.

<!doctype html>
<html lang="en-US">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width" />
    <title>Mouse Capture Example</title>
    <style>
      #myButton {
        border: solid black 1px;
        color: black;
        padding: 2px;
        box-shadow: black 2px 2px;
      }
    </style>

    <script>
      function init() {
        const btn = document.getElementById("myButton");
        if (btn.setCapture) {
          btn.addEventListener("mousedown", mouseDown, false);
          btn.addEventListener("mouseup", mouseUp, false);
        } else {
          document.getElementById("output").textContent =
            "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) {
        const output = document.getElementById("output");
        output.textContent = `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>

Просмотреть примеры

Примечания

Элемент может не прокручиваться полностью до самого верха или низа, в зависимости от макета других элементов.

Спецификации

Не входит в состав какой-либо спецификации.

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setCapture`	Нет	12–79	4	Нет	Нет	Нет	4	Нет	Нет	Нет	Нет

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/setCapture