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

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2020 года.

Метод releasePointerCapture() интерфейса Element освобождает (останавливает) захват указателя, который был ранее задан для конкретного (PointerEvent) указателя.

Синтаксис

releasePointerCapture(pointerId)

Параметры

pointerId: Идентификатор pointerId объекта PointerEvent.

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

None (undefined).

Исключения

NotFoundError DOMException: Выбрасывается, если pointerId не соответствует ни одному активному указателю.

Примеры

В этом примере устанавливается захват указателя для <div> при нажатии на него. Это позволяет перемещать элемент горизонтально, даже когда указатель выходит за его пределы.

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;

Результат

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

Спецификация
Pointer Events # dom-element-releasepointercapture

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`releasePointerCapture`	55	12	59	42	13	55	79	42	13	6.0	55

См. также

© 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/releasePointerCapture