CKTIS / JavaScript
Povlačenje s hvatanjem pokazivača: potvrda ili vraćanje vrijednosti
Odvoji pretpregled od potvrđene vrijednosti i dovrši povlačenje samo jednom, čak i ako se hvatanje izgubi nakon otpuštanja tipke.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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);
}S povlačenjem uz hvatanje postupaj kao s transakcijom. Na pointerdown spremi početnu vrijednost i pointerId, a zatim pozovi element.setPointerCapture(event.pointerId) kako bi sljedeći događaji tog pokazivača stizali elementu i izvan njegovih granica. Podudarni događaji pointermove ažuriraju samo pretpregled. Pomicanje je moguće i bez dodira ili pritisnute tipke. pointermove može javiti, primjerice, promjenu pritiska, a preglednik može spojiti više uzoraka u jedan događaj.
Potvrdi pretpregled samo na pointerup. Vrati početnu vrijednost na pointercancel, primjerice kad preglednik preuzme gestu radi pomicanja stranice, ili na lostpointercapture ako je povlačenje još u tijeku. U zajedničkoj funkciji za završetak provjeri identifikator i obriši aktivno stanje prije potvrde ili vraćanja vrijednosti. Tako gubitak hvatanja nakon pointerup ili pointercancel ne mijenja rezultat ponovno. Gubitak hvatanja ne znači da je pokazivač otpušten.
Izravan dodir može pokrenuti implicitno hvatanje. setPointerCapture() baca iznimku NotFoundError ako identifikator ne odgovara aktivnom pokazivaču. Hvatanje možeš ranije otpustiti metodom releasePointerCapture(); preglednik ga automatski otpušta nakon pointerup ili pointercancel. Postavi CSS svojstvo touch-action prije geste i ograniči touch-action: none na potrebno područje jer može blokirati zumiranje dodirom.
Ovi događaji upotrebljavaju web API PointerEvent preglednika i ne zahtijevaju ECMAScript 2024. Kod prsta ili vrha olovke pointerdown i pointerup označavaju početak i kraj dodira. Kod miša označavaju pritisak prve i otpuštanje posljednje tipke, a ne svaki pojedinačni pritisak ili otpuštanje kao mousedown i mouseup.
Primjeri
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;
});Rezultat
pointerdown pointermove pointerup lostpointercapture
Pokreni primjer uz Node.js i Playwright prema uputama za provjeru. Playwright pritišće tipku u panelu, pomiče miš izvan panela i ondje otpušta tipku. Bilježi se samo prvi odgovarajući pomak. Očekivani izlaz pokazuje uobičajeni završetak, a ne otkazivanje ili prijevremeni gubitak hvatanja.
Povezane lekcije
- JavaScript · Lekcija 35 · Napredno · Verzija: 4