CKTIS / JavaScript
Glissement avec capture du pointeur : valider ou rétablir la valeur initiale
Séparez l’aperçu de la valeur validée et ne terminez le glissement qu’une fois, même si la capture est perdue après le relâchement.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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);
}Traitez le glissement avec capture comme une transaction. À pointerdown, mémorisez la valeur initiale et le pointerId, puis appelez element.setPointerCapture(event.pointerId) pour que les évènements suivants de ce pointeur atteignent l’élément même en dehors de ses limites. Les évènements pointermove correspondants ne modifient que l’aperçu. Le mouvement peut aussi se produire au survol ; pointermove peut signaler un changement de pression, par exemple, et le navigateur peut regrouper plusieurs échantillons dans un évènement.
Ne validez l’aperçu que sur pointerup. Rétablissez la valeur initiale sur pointercancel, par exemple si le navigateur prend en charge le geste pour faire défiler la page, ou sur lostpointercapture si le glissement est encore actif. Dans la fonction de finalisation commune, vérifiez l’identifiant du pointeur et effacez l’état actif avant de valider ou de rétablir la valeur. Ainsi, la perte de capture après pointerup ou pointercancel ne change plus le résultat. Perdre la capture ne signifie pas que le pointeur a été relâché.
Un contact tactile direct peut déclencher une capture implicite. setPointerCapture() lève NotFoundError si l’identifiant ne correspond à aucun pointeur actif. releasePointerCapture() permet de libérer la capture plus tôt ; le navigateur la libère automatiquement après pointerup ou pointercancel. Définissez la propriété CSS touch-action avant le geste et limitez touch-action: none à la zone nécessaire, car elle peut bloquer le zoom tactile.
Ces évènements utilisent l’API web PointerEvent du navigateur et ne nécessitent pas ECMAScript 2024. Pour un doigt ou la pointe d’un stylet, pointerdown et pointerup marquent le début et la fin du contact. Pour la souris, ils signalent la pression du premier bouton et le relâchement du dernier, et non chaque pression ou relâchement comme mousedown et mouseup.
Exemples
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;
});Résultat
pointerdown pointermove pointerup lostpointercapture
Exécutez l’exemple avec Node.js et Playwright comme indiqué dans les instructions de vérification. Playwright appuie dans le panneau, déplace la souris hors du panneau et relâche le bouton à cet endroit. Seul le premier mouvement correspondant est journalisé. La sortie attendue montre une fin normale, pas une annulation ni une perte prématurée de capture.
Leçons associées
- JavaScript · Leçon 35 · Avancé · Version : 4