CKTIS / JavaScript
Ťahanie so zachytením ukazovateľa: potvrdenie alebo obnovenie hodnoty
Oddeľte náhľad od potvrdenej hodnoty a ukončite ťahanie iba raz, aj keď strata zachytenia nastane až po uvoľnení ukazovateľa.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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);
}Pri ťahaní so zachytením ukazovateľa pracujte so zmenou ako s transakciou. Pri pointerdown uložte počiatočnú hodnotu a pointerId a zavolajte element.setPointerCapture(event.pointerId). Ďalšie udalosti tohto ukazovateľa budú smerovať na prvok aj mimo jeho hraníc. Zodpovedajúce udalosti pointermove menia iba náhľad. Pohyb môže nastať aj bez kontaktu alebo stlačeného tlačidla. pointermove môže hlásiť napríklad zmenu prítlaku a prehliadač môže zlúčiť viacero vzoriek do jednej udalosti.
Náhľad potvrďte iba pri pointerup. Počiatočnú hodnotu obnovte pri pointercancel, napríklad keď prehliadač prevezme gesto na posúvanie stránky, alebo pri lostpointercapture, ak ťahanie ešte prebieha. V spoločnej dokončovacej funkcii overte identifikátor a zrušte aktívny stav pred potvrdením alebo obnovením hodnoty. Strata zachytenia po pointerup alebo pointercancel potom výsledok nezmení druhýkrát. Strata zachytenia neznamená uvoľnenie ukazovateľa.
Priamy dotyk môže spustiť implicitné zachytenie. setPointerCapture() vyvolá výnimku NotFoundError, ak identifikátor nezodpovedá aktívnemu ukazovateľu. Zachytenie môžete uvoľniť skôr pomocou releasePointerCapture(); po pointerup alebo pointercancel ho prehliadač uvoľní automaticky. Vlastnosť CSS touch-action nastavte pred gestom a touch-action: none obmedzte na potrebnú oblasť, pretože môže zablokovať priblíženie dotykom.
Tieto udalosti používajú webové API PointerEvent prehliadača a nevyžadujú ECMAScript 2024. Pri dotyku prstom alebo hrotom pera označujú pointerdown a pointerup začiatok a koniec kontaktu. Pri myši hlásia stlačenie prvého a uvoľnenie posledného tlačidla, nie každé stlačenie alebo uvoľnenie ako mousedown a mouseup.
Príklady
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;
});Výsledok
pointerdown pointermove pointerup lostpointercapture
Spustite príklad v Node.js s Playwrightom podľa pokynov na overenie. Playwright stlačí tlačidlo v paneli, presunie myš mimo panela a tam tlačidlo uvoľní. Zaznamená sa iba prvý zodpovedajúci pohyb. Očakávaný výstup ukazuje bežné dokončenie, nie zrušenie alebo predčasnú stratu zachytenia.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Pokročilá · Verzia: 4