CKTIS / JavaScript
Vlečenje z zajemom kazalca: potrditev ali obnovitev vrednosti
Loči predogled od potrjene vrednosti in zaključi vlečenje samo enkrat, tudi če se zajem izgubi šele po spustu tipke.
Različica: 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);
}Vlečenje z zajemom obravnavaj kot transakcijo. Ob pointerdown shrani začetno vrednost in pointerId, nato pokliči element.setPointerCapture(event.pointerId), da naslednji dogodki tega kazalca dosežejo element tudi zunaj njegovih meja. Ustrezni dogodki pointermove posodabljajo le predogled. Premik je mogoč tudi brez stika ali pritisnjene tipke. pointermove lahko na primer sporoči spremembo pritiska, brskalnik pa lahko več vzorcev združi v en dogodek.
Predogled potrdi le ob pointerup. Začetno vrednost obnovi ob pointercancel, na primer ko brskalnik prevzame potezo za pomikanje strani, ali ob lostpointercapture, če vlečenje še poteka. V skupni zaključni funkciji preveri identifikator in počisti aktivno stanje, preden potrdiš ali obnoviš vrednost. Tako izguba zajema po pointerup ali pointercancel ne spremeni rezultata še enkrat. Izguba zajema ne pomeni, da je bil kazalec sproščen.
Neposreden dotik lahko sproži implicitni zajem. setPointerCapture() sproži izjemo NotFoundError, če identifikator ne pripada aktivnemu kazalcu. Z releasePointerCapture() lahko zajem sprostiš prej; brskalnik ga po pointerup ali pointercancel sprosti samodejno. Lastnost CSS touch-action nastavi pred potezo in omeji touch-action: none na potrebno območje, saj lahko onemogoči povečavo z dotikom.
Ti dogodki uporabljajo spletni API PointerEvent brskalnika in ne zahtevajo ECMAScript 2024. Pri prstu ali konici pisala pointerdown in pointerup označujeta začetek in konec stika. Pri miški označujeta pritisk prve in spust zadnje tipke, ne vsakega posameznega pritiska ali spusta kot mousedown in mouseup.
Primeri
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
Zaženi primer z Node.js in Playwrightom po navodilih za preverjanje. Playwright pritisne tipko znotraj plošče, premakne miško iz plošče in tipko tam spusti. Zabeleži se le prvi ustrezni premik. Pričakovani izpis prikazuje običajen zaključek, ne preklica ali prezgodnje izgube zajema.
Povezane lekcije
- JavaScript · Lekcija 35 · Napredna · Različica: 4