CKTIS / JavaScript
Прихващане на указателя: потвърждаване или прекратяване на влачене
Проследявай влаченето по `pointerId` и го приключвай само веднъж: потвърди резултата при отпускане или го отхвърли при отмяна или ранна загуба на прихващане.
Версия: Current web platform; runtime support varies
Синтаксис
// Handler sketch: supply the element and the five callbacks in your application.
element.addEventListener("pointerdown", onDown);
element.addEventListener("pointermove", onMove);
element.addEventListener("pointerup", onUp);
element.addEventListener("pointercancel", onCancel);
element.addEventListener("lostpointercapture", onLostCapture);
// In onDown, after accepting the pointer for the drag:
// element.setPointerCapture(event.pointerId);
// In onMove, only if the active drag should release capture early:
// element.releasePointerCapture(event.pointerId);В началото на влаченето запази pointerId на указателя, който приемаш при pointerdown. Събитието възниква при натискане на първия бутон на мишката или когато пръст или връх на писалка докосне повърхността. Обновявай състоянието на влаченето само при събития pointermove със запазения идентификатор. pointermove може да съобщи промяна на позицията или друго свойство, например натиск, и може да възникне и без контакт или натиснат бутон.
Извикай element.setPointerCapture(pointerId), за да проследяваш влаченето и извън елемента. Директното докосване може да задейства прихващане неявно. Ако трябва да го освободиш по-рано, използвай releasePointerCapture(). И двата метода могат да предизвикат NotFoundError, ако идентификаторът не съответства на активен указател.
Потвърди резултата при pointerup: пръстът или писалката се вдига, или се отпуска последният натиснат бутон на мишката. За разлика от mousedown и mouseup, pointerdown и pointerup не възникват при всяка промяна на бутон. При pointercancel отхвърли временното състояние: браузърът е прекъснал взаимодействието, например за да поеме жест за превъртане или мащабиране.
И в двата случая изчисти запазения идентификатор, за да не приключи влаченето повторно при автоматичното освобождаване на прихващането след pointerup или pointercancel. lostpointercapture означава загуба на прихващане, а не непременно край на контакта. Прекрати влаченето само ако още тече и събитието е със същия идентификатор.
Прихващането не блокира жестовете на браузъра: настрой ги предварително със свойството на CSS touch-action и ограничи none до необходимата област. Тези API са част от уеб платформата, не от ECMAScript 2024; наличността им зависи от средата за изпълнение.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Drag with pointer capture</title>
<style>
#pad {
position: fixed;
top: 16px;
left: 16px;
z-index: 9999;
width: 220px;
height: 100px;
padding: 12px;
background: #def;
color: #123;
border: 2px solid #246;
touch-action: none;
user-select: none;
}
</style>
</head>
<body>
<div id="pad">Start dragging here</div>
<script>
(() => {
const pad = document.getElementById('pad');
let activeId = null;
let moved = false;
pad.addEventListener('pointerdown', (event) => {
if (activeId !== null || event.button !== 0) return;
pad.setPointerCapture(event.pointerId);
activeId = event.pointerId;
moved = false;
console.log('pointerdown');
});
pad.addEventListener('pointermove', (event) => {
if (event.pointerId !== activeId) return;
if (!moved) {
moved = true;
console.log('pointermove');
}
if (event.shiftKey && pad.hasPointerCapture(event.pointerId)) {
pad.releasePointerCapture(event.pointerId);
}
});
function finish(event, result) {
if (event.pointerId !== activeId) return;
activeId = null;
console.log(`${event.type}: ${result}`);
}
pad.addEventListener('pointerup', (event) => finish(event, 'commit'));
pad.addEventListener('pointercancel', (event) => finish(event, 'abort'));
pad.addEventListener('lostpointercapture', (event) => finish(event, 'abort'));
})();
</script>
</body>
</html>Резултат
pointerdown pointermove pointerup: commit
Запази примера като HTML файл, отвори го в браузър и наблюдавай конзолата за разработчици. Започни влаченето с основния бутон на мишката в полето и го отпусни извън него, без да държиш Shift. При отделно влачене първо раздвижи мишката, после задръж Shift и продължи да я движиш, без да отпускаш бутона, за да провериш ранната загуба на прихващане. Редът `pointermove` се появява най-много веднъж на влачене.
Свързани уроци
- JavaScript · Урок 35 · Средно · Версия: 3