CKTIS / JavaScript
Плъзгане с прихванат указател: потвърждаване или възстановяване на стойността
Дръж временния изглед отделно от потвърдената стойност и приключвай плъзгането само веднъж, дори ако прихващането се загуби след отпускането.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
let drag = null;
// beginDrag saves the pointer ID and a snapshot, then captures the pointer.
// updatePreview changes only the preview for the matching pointer ID.
element.addEventListener('pointerdown', beginDrag);
element.addEventListener('pointermove', updatePreview);
element.addEventListener('pointerup', (event) => settle(event, true));
element.addEventListener('pointercancel', (event) => settle(event, false));
element.addEventListener('lostpointercapture', (event) => settle(event, false));
function settle(event, commit) {
if (drag === null || event.pointerId !== drag.pointerId) return;
const current = drag;
drag = null;
if (commit) commitPreview(current);
else restoreSnapshot(current);
}Разглеждай плъзгането с прихванат указател като транзакция. При pointerdown запази началната стойност и pointerId, след което извикай element.setPointerCapture(event.pointerId), за да получава елементът следващите събития от този указател дори извън границите си. Съответстващите събития pointermove обновяват само временния изглед. Движение е възможно и без контакт или натиснат бутон. pointermove може да отчете например промяна на натиска, а браузърът може да обедини няколко измервания в едно събитие.
Потвърди временната стойност само при pointerup. Възстанови началната стойност при pointercancel, например когато браузърът поеме жеста за превъртане, или при lostpointercapture, ако плъзгането още е активно. В общата функция за приключване провери идентификатора и изчисти активното състояние, преди да потвърдиш или възстановиш стойността. Така загубата на прихващането след pointerup или pointercancel не променя резултата повторно. Загубата на прихващане не означава, че указателят е бил освободен.
Прякото докосване може да задейства неявно прихващане. setPointerCapture() хвърля NotFoundError, ако идентификаторът не отговаря на активен указател. Можеш да освободиш прихващането по-рано с releasePointerCapture(); браузърът го освобождава автоматично след pointerup или pointercancel. Задай CSS свойството touch-action преди жеста и ограничи touch-action: none до нужната област, защото може да блокира увеличаването чрез докосване.
Тези събития използват уеб API PointerEvent на браузъра и не изискват ECMAScript 2024. При пръст или връх на писалка pointerdown и pointerup отбелязват началото и края на контакта. При мишка те отчитат натискането на първия и отпускането на последния бутон, а не всяко отделно натискане или отпускане като mousedown и mouseup.
Примери
const assert = require('node:assert/strict');
const { chromium } = require('playwright');
async function main() {
const browser = await chromium.launch();
try {
const page = await browser.newPage({ viewport: { width: 480, height: 240 } });
page.on('console', (message) => {
if (message.type() === 'log') console.log(message.text());
});
await page.setContent(`
<div id="pad" style="position:fixed;top:16px;left:16px;box-sizing:border-box;
width:180px;height:84px;padding:16px;background:#def;color:#123;
touch-action:none;user-select:none">Press here, move outside, then release</div>
<output id="position" data-committed="0"
style="position:fixed;top:116px;left:16px">0</output>
`);
await page.evaluate(() => {
const pad = document.querySelector('#pad');
const position = document.querySelector('#position');
let committed = 0;
let drag = null;
let capturedId = null;
pad.addEventListener('pointerdown', (event) => {
if (!event.isTrusted || event.button !== 0 || capturedId !== null) return;
pad.setPointerCapture(event.pointerId);
capturedId = event.pointerId;
drag = {
pointerId: event.pointerId,
startX: event.clientX,
snapshot: committed,
preview: committed,
loggedMove: false
};
console.log(event.type);
});
pad.addEventListener('pointermove', (event) => {
if (drag === null || event.pointerId !== drag.pointerId) return;
drag.preview = drag.snapshot + event.clientX - drag.startX;
position.textContent = String(drag.preview);
if (!drag.loggedMove) {
drag.loggedMove = true;
console.log(event.type);
}
});
function settle(event, commit) {
if (drag === null || event.pointerId !== drag.pointerId) return false;
const current = drag;
drag = null;
if (commit) committed = current.preview;
position.dataset.committed = String(committed);
position.textContent = String(commit ? committed : current.snapshot);
return true;
}
pad.addEventListener('pointerup', (event) => {
if (settle(event, true)) console.log(event.type);
});
pad.addEventListener('pointercancel', (event) => {
if (settle(event, false)) console.log(event.type);
});
pad.addEventListener('lostpointercapture', (event) => {
if (event.pointerId !== capturedId) return;
capturedId = null;
settle(event, false);
console.log(event.type);
});
});
// Drive Chromium's mouse rather than dispatching synthetic pointer events.
await page.mouse.move(40, 40);
await page.mouse.down();
await page.mouse.move(320, 40);
await page.mouse.move(340, 40);
const position = page.locator('#position');
assert.equal(await position.textContent(), '300');
assert.equal(await position.getAttribute('data-committed'), '0');
await page.mouse.up();
assert.equal(await position.getAttribute('data-committed'), '300');
assert.equal(await position.textContent(), '300');
} finally {
await browser.close();
}
}
main().catch((error) => {
console.error(error);
process.exitCode = 1;
});Резултат
pointerdown pointermove pointerup lostpointercapture
Изпълни примера с Node.js и Playwright според указанията за проверка. Playwright натиска бутона в панела, премества мишката извън него и отпуска бутона там. Записва се само първото съответстващо движение. Очакваният изход показва нормално завършване, а не отмяна или преждевременна загуба на прихващане.
Свързани уроци
- JavaScript · Урок 35 · Напреднало · Версия: 4