CKTIS / JavaScript
Element.releasePointerCapture() — освобождаване на прихващането на показалеца
releasePointerCapture(pointerId) освобождава прихващането на конкретен показалец от даден елемент и възстановява обичайното определяне на целта на събитията според позицията.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.releasePointerCapture(pointerId)Element.releasePointerCapture освобождава прихващането на показалеца, обозначен с pointerId, който обикновено се получава от събитие. Методът връща undefined. Прихващането насочва събитията към елемента дори когато показалецът е извън границите му; освобождаването възстановява обичайното определяне на целта според позицията. То не прекратява физическия контакт или натискането на бутон.
Неактивен идентификатор предизвиква DOMException с име NotFoundError. При активен показалец методът не прави нищо, ако този елемент не го прихваща. hasPointerCapture(pointerId) проверява състоянието на прихващане в очакване; освобождаването изчиства това състояние незабавно, но lostpointercapture не е задължително да бъде задействано синхронно.
Браузърът освобождава прихващането и след pointerup или pointercancel. Примерът го освобождава по-рано, при първото движение след натискането. Това е браузърен API за Pointer Events, а не функция на ECMAScript; Node 24 не доказва, че е наличен. Проверете поддръжката в целевите браузъри.
Примери
const pad = document.createElement('button');
pad.textContent = 'Press and move';
pad.style.touchAction = 'none';
document.body.append(pad);
pad.addEventListener('pointerdown', (event) => {
pad.setPointerCapture(event.pointerId);
});
pad.addEventListener('pointermove', (event) => {
if (pad.hasPointerCapture(event.pointerId)) {
const result = pad.releasePointerCapture(event.pointerId);
console.log(result, pad.hasPointerCapture(event.pointerId));
}
});Резултат
undefined false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.