KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Slepen met pointer capture: waarde vastleggen of herstellen

Houd de voorbeeldwaarde gescheiden van de vastgelegde waarde en rond het slepen één keer af, ook als de capture pas na het loslaten verloren gaat.

Versie: 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);
}

Behandel slepen met pointer capture als een transactie. Sla bij pointerdown de beginwaarde en de pointerId op en roep element.setPointerCapture(event.pointerId) aan. Daardoor bereiken volgende gebeurtenissen van die pointer het element ook buiten zijn grenzen. Passende pointermove-gebeurtenissen werken alleen de voorbeeldwaarde bij. Beweging is ook mogelijk zonder contact of ingedrukte knop. pointermove kan bijvoorbeeld een drukverandering melden, en de browser kan meerdere metingen samenvoegen tot één gebeurtenis.

Leg de voorbeeldwaarde alleen vast bij pointerup. Herstel de beginwaarde bij pointercancel, bijvoorbeeld als de browser het gebaar overneemt om te scrollen, of bij lostpointercapture als het slepen nog actief is. Controleer in de gedeelde afrondingsfunctie de pointer-ID en wis de actieve sleepstatus voordat je de waarde vastlegt of herstelt. Zo verandert captureverlies na pointerup of pointercancel het resultaat niet opnieuw. Captureverlies betekent niet dat de pointer is losgelaten.

Directe aanraking kan impliciete capture activeren. setPointerCapture() geeft NotFoundError als de ID niet bij een actieve pointer hoort. Met releasePointerCapture() kun je capture eerder opheffen; de browser doet dit automatisch na pointerup of pointercancel. Stel de CSS-eigenschap touch-action vóór het gebaar in en beperk touch-action: none tot het noodzakelijke gebied, omdat het zoomen via aanraking kan blokkeren.

Deze gebeurtenissen gebruiken de web-API PointerEvent van de browser en vereisen geen ECMAScript 2024. Bij een vinger of penpunt markeren pointerdown en pointerup het begin en einde van het contact. Bij de muis melden ze het indrukken van de eerste knop en het loslaten van de laatste, niet elke afzonderlijke knopdruk of -loslating zoals mousedown en mouseup.

Voorbeelden

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;
});

Resultaat

pointerdown
pointermove
pointerup
lostpointercapture

Voer het voorbeeld met Node.js en Playwright uit zoals beschreven in de verificatie-instructies. Playwright drukt de muisknop in het paneel in, beweegt de muis naar buiten en laat de knop daar los. Alleen de eerste passende beweging wordt gelogd. De verwachte uitvoer toont een normale afronding, geen annulering of voortijdig captureverlies.

Gerelateerde lessen

  • JavaScript · Les 35 · Gevorderd · Versie: 4

Bronnen