KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Pointer capture: een sleepactie afronden of afbreken

Volg één sleepactie met `pointerId` en beëindig die maar één keer: bevestig het resultaat bij loslaten of verwerp het bij annulering of vroegtijdig verlies van pointer capture.

Versie: Current web platform; runtime support varies

Syntax

// Handler sketch: supply the element and the five callbacks in your application.
element.addEventListener("pointerdown", onDown);
element.addEventListener("pointermove", onMove);
element.addEventListener("pointerup", onUp);
element.addEventListener("pointercancel", onCancel);
element.addEventListener("lostpointercapture", onLostCapture);

// In onDown, after accepting the pointer for the drag:
// element.setPointerCapture(event.pointerId);
// In onMove, only if the active drag should release capture early:
// element.releasePointerCapture(event.pointerId);

Bewaar aan het begin van de sleepactie de pointerId van de pointer die je bij pointerdown accepteert. Die gebeurtenis treedt op wanneer de eerste muisknop wordt ingedrukt of een vinger of penpunt het oppervlak raakt. Werk de toestand van de sleepactie alleen bij voor pointermove-gebeurtenissen met het opgeslagen ID. pointermove kan een verandering van positie of van een andere eigenschap, zoals druk, melden en ook optreden zonder contact of ingedrukte knop.

Roep element.setPointerCapture(pointerId) aan om de sleepactie ook buiten het element te volgen. Directe aanraking kan capture impliciet inschakelen. Gebruik releasePointerCapture() als je capture eerder wilt vrijgeven. Beide methoden kunnen NotFoundError geven als het ID niet bij een actieve pointer hoort.

Bevestig het resultaat bij pointerup: de vinger of pen gaat omhoog, of de laatst ingedrukte muisknop wordt losgelaten. Anders dan mousedown en mouseup treden pointerdown en pointerup niet op bij elke wijziging van een muisknop. Gooi de tijdelijke toestand weg bij pointercancel: de browser heeft de interactie onderbroken, bijvoorbeeld om een scroll- of zoomgebaar over te nemen.

Wis in beide gevallen het opgeslagen ID, zodat de automatische vrijgave na pointerup of pointercancel de sleepactie niet een tweede keer beëindigt. lostpointercapture meldt verlies van capture, niet noodzakelijk het einde van contact. Breek de sleepactie alleen af als die nog bezig is en de gebeurtenis hetzelfde ID heeft.

Capture blokkeert browsergebaren niet: stel de afhandeling vooraf in met de CSS-eigenschap touch-action en beperk none tot het gebied waar het nodig is. Deze API’s behoren tot het webplatform, niet tot ECMAScript 2024; beschikbaarheid hangt af van de uitvoeromgeving.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Drag with pointer capture</title>
  <style>
    #pad {
      position: fixed;
      top: 16px;
      left: 16px;
      z-index: 9999;
      width: 220px;
      height: 100px;
      padding: 12px;
      background: #def;
      color: #123;
      border: 2px solid #246;
      touch-action: none;
      user-select: none;
    }
  </style>
</head>
<body>
  <div id="pad">Start dragging here</div>
  <script>
    (() => {
      const pad = document.getElementById('pad');
      let activeId = null;
      let moved = false;

      pad.addEventListener('pointerdown', (event) => {
        if (activeId !== null || event.button !== 0) return;
        pad.setPointerCapture(event.pointerId);
        activeId = event.pointerId;
        moved = false;
        console.log('pointerdown');
      });

      pad.addEventListener('pointermove', (event) => {
        if (event.pointerId !== activeId) return;
        if (!moved) {
          moved = true;
          console.log('pointermove');
        }
        if (event.shiftKey && pad.hasPointerCapture(event.pointerId)) {
          pad.releasePointerCapture(event.pointerId);
        }
      });

      function finish(event, result) {
        if (event.pointerId !== activeId) return;
        activeId = null;
        console.log(`${event.type}: ${result}`);
      }

      pad.addEventListener('pointerup', (event) => finish(event, 'commit'));
      pad.addEventListener('pointercancel', (event) => finish(event, 'abort'));
      pad.addEventListener('lostpointercapture', (event) => finish(event, 'abort'));
    })();
  </script>
</body>
</html>

Resultaat

pointerdown
pointermove
pointerup: commit

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de ontwikkelaarsconsole. Begin binnen het vak te slepen met de primaire muisknop en laat die buiten het vak los zonder Shift ingedrukt te houden. Begin bij een tweede sleepactie eerst te bewegen, houd dan Shift ingedrukt en blijf bewegen zonder de muisknop los te laten om vroegtijdig verlies van capture te testen. De regel `pointermove` verschijnt hoogstens één keer per sleepactie.

Gerelateerde lessen

  • JavaScript · Les 35 · Gemiddeld · Versie: 3

Bronnen