CKTIS / JavaScript
Przeciąganie z przechwyceniem wskaźnika: zatwierdzanie i cofanie zmian
Oddziel podgląd od zatwierdzonej wartości i zakończ przeciąganie tylko raz, nawet jeśli po zwolnieniu wskaźnika nastąpi utrata przechwycenia.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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);
}Traktuj przeciąganie jako operację z podglądem. Przy pointerdown zapisz początkową wartość i pointerId, a następnie wywołaj element.setPointerCapture(event.pointerId). Przechwycenie kieruje kolejne zdarzenia tego wskaźnika do elementu także poza jego granicami. Pasujące zdarzenia pointermove aktualizują tylko podgląd. Ruch może wystąpić także bez wciśniętego przycisku, a pointermove może zgłaszać np. zmianę nacisku lub obejmować kilka próbek ruchu.
Zatwierdź podgląd tylko przy pointerup. Przy pointercancel, np. gdy przeglądarka przejmie gest, aby przewinąć stronę, przywróć wartość początkową. Zrób to samo, jeśli lostpointercapture nadejdzie przed zakończeniem przeciągania. We wspólnej funkcji kończącej najpierw sprawdź identyfikator i wyczyść stan aktywnego przeciągania. Dzięki temu utrata przechwycenia po pointerup lub pointercancel nie zmieni wyniku po raz drugi. Przechwycenie i przeciąganie to osobne stany: lostpointercapture nie oznacza zwolnienia przycisku.
Przy bezpośrednim dotyku przechwycenie może nastąpić automatycznie. setPointerCapture() zgłasza NotFoundError, jeśli identyfikator nie odpowiada aktywnemu wskaźnikowi. Możesz zwolnić przechwycenie wcześniej przez releasePointerCapture(); przeglądarka zwalnia je automatycznie po pointerup lub pointercancel. Ustaw CSS touch-action przed gestem i ogranicz touch-action: none do potrzebnego obszaru, ponieważ może blokować powiększanie dotykiem.
Te zdarzenia używają interfejsu PointerEvent z interfejsów API przeglądarki; nie wymagają ECMAScript 2024. Przy dotyku lub kontakcie końcówki pióra pointerdown i pointerup oznaczają początek i koniec kontaktu. W przypadku myszy oznaczają wciśnięcie pierwszego i zwolnienie ostatniego przycisku, a nie każde wciśnięcie i zwolnienie z osobna jak mousedown i mouseup.
Przykłady
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;
});Wynik
pointerdown pointermove pointerup lostpointercapture
Uruchom przykład w Node.js z Playwright zgodnie z instrukcją weryfikacji. Playwright wciska przycisk myszy w panelu, przesuwa wskaźnik poza panel i tam zwalnia przycisk. Kod zapisuje tylko pierwszy pasujący ruch. Oczekiwany wynik dotyczy zwykłego zakończenia, nie anulowania ani wcześniejszej utraty przechwycenia.
Powiązane lekcje
- JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4