Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Hvatanje pokazivača: potvrda ili prekid povlačenja

Prati povlačenje prema `pointerId` i završi ga samo jednom: potvrdi rezultat pri otpuštanju ili ga odbaci pri otkazivanju ili prijevremenom gubitku hvatanja.

Verzija: Current web platform; runtime support varies

Sintaksa

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

Na početku povlačenja spremi pointerId pokazivača koji prihvatiš pri događaju pointerdown. Događaj se pokreće kad se pritisne prvi gumb miša ili kad prst odnosno vrh olovke dodirne površinu. Ažuriraj stanje povlačenja samo za događaje pointermove s tim identifikatorom. pointermove može javiti promjenu položaja ili drugog svojstva, primjerice pritiska, a može se dogoditi i bez dodira ili pritisnutog gumba.

Pozovi element.setPointerCapture(pointerId) kako bi pratio povlačenje i izvan elementa. Izravan dodir može implicitno pokrenuti hvatanje. Ako pokazivač treba otpustiti ranije, upotrijebi releasePointerCapture(). Obje metode mogu izazvati NotFoundError ako identifikator ne pripada aktivnom pokazivaču.

Potvrdi rezultat na pointerup: prst ili olovka podiže se ili se otpušta zadnji pritisnuti gumb miša. Za razliku od mousedown i mouseup, pointerdown i pointerup ne pokreću se pri svakoj promjeni stanja gumba. Na pointercancel odbaci privremeno stanje: preglednik je prekinuo interakciju, primjerice da bi preuzeo gestu pomicanja ili zumiranja.

U oba slučaja izbriši spremljeni identifikator kako automatsko otpuštanje nakon pointerup ili pointercancel ne bi završilo povlačenje drugi put. lostpointercapture označava gubitak hvatanja, ne nužno kraj dodira. Prekini povlačenje samo ako još traje i događaj ima isti identifikator.

Hvatanje ne blokira geste preglednika: unaprijed ih konfiguriraj CSS svojstvom touch-action, a none ograniči na potrebno područje. Ti API-ji pripadaju web-platformi, a ne ECMAScriptu 2024; dostupnost ovisi o okruženju izvođenja.

Primjeri

<!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>

Rezultat

pointerdown
pointermove
pointerup: commit

Spremi primjer kao HTML datoteku, otvori je u pregledniku i prati razvojnu konzolu. Pokreni povlačenje glavnim gumbom miša unutar okvira i otpusti gumb izvan njega bez držanja tipke Shift. Pri drugom povlačenju prvo pomakni miš, zatim drži Shift i nastavi pomicati miš bez otpuštanja gumba da provjeriš prijevremeni gubitak hvatanja. Redak `pointermove` pojavljuje se najviše jednom po povlačenju.

Povezane lekcije

  • JavaScript · Lekcija 35 · Srednje · Verzija: 3

Izvori