CKTIS / JavaScript
Ziehen mit Zeigererfassung: Änderungen übernehmen oder zurücksetzen
Trenne die Vorschau vom übernommenen Wert und schließe den Ziehvorgang nur einmal ab, auch wenn die Erfassung erst nach dem Loslassen verloren geht.
Version: 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);
}Behandle einen Ziehvorgang mit Zeigererfassung wie eine Transaktion. Speichere bei pointerdown den Ausgangswert und die pointerId. Rufe dann element.setPointerCapture(event.pointerId) auf, damit weitere Ereignisse des Zeigers das Element auch außerhalb seiner Grenzen erreichen. Passende pointermove-Ereignisse ändern nur die Vorschau. Bewegung ist auch ohne gedrückte Taste möglich. pointermove kann beispielsweise eine Druckänderung melden, und der Browser kann mehrere Bewegungsmesswerte in einem Ereignis zusammenfassen.
Übernimm die Vorschau nur bei pointerup. Stelle bei pointercancel den Ausgangswert wieder her, etwa wenn der Browser die Geste zum Scrollen übernimmt. Dasselbe gilt bei lostpointercapture, solange der Ziehvorgang noch aktiv ist. Prüfe in der gemeinsamen Abschlussfunktion die Zeiger-ID und setze den aktiven Zustand zurück, bevor du das Ergebnis übernimmst oder verwirfst. So ändert der Verlust der Erfassung nach pointerup oder pointercancel das Ergebnis nicht mehr. Der Verlust der Erfassung bedeutet nicht, dass der Zeiger losgelassen wurde.
Direkte Berührung kann eine implizite Erfassung auslösen. setPointerCapture() löst NotFoundError aus, wenn die ID zu keinem aktiven Zeiger gehört. Mit releasePointerCapture() kannst du die Erfassung vorzeitig aufheben; nach pointerup oder pointercancel geschieht das automatisch. Lege die CSS-Eigenschaft touch-action vor der Geste fest und beschränke touch-action: none auf den nötigen Bereich, da es das Zoomen per Berührung blockieren kann.
Diese Ereignisse nutzen die Web-API PointerEvent des Browsers und setzen ECMAScript 2024 nicht voraus. Bei Finger oder Stiftspitze markieren pointerdown und pointerup den Kontakt und das Abheben. Bei der Maus melden sie das Drücken der ersten und das Loslassen der letzten Taste, nicht jede einzelne Tastenbetätigung wie mousedown und mouseup.
Beispiele
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;
});Ergebnis
pointerdown pointermove pointerup lostpointercapture
Führe das Beispiel mit Node.js und Playwright wie in der Prüfanleitung beschrieben aus. Playwright drückt die Maustaste im Feld, bewegt den Zeiger aus dem Feld und lässt die Taste dort los. Nur die erste passende Bewegung wird protokolliert. Die erwartete Ausgabe zeigt den regulären Abschluss, keinen Abbruch oder vorzeitigen Verlust der Erfassung.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Fortgeschritten · Version: 4