Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Zachytenie ukazovateľa: potvrdenie alebo prerušenie ťahania

Sleduj ťahanie podľa `pointerId` a ukonči ho len raz: pri uvoľnení potvrď výsledok, pri zrušení alebo predčasnej strate zachytenia ho zahoď.

Verzia: 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);

Na začiatku ťahania ulož pointerId ukazovateľa, ktorý prijmeš pri pointerdown. Táto udalosť nastane, keď sa stlačí prvé tlačidlo myši alebo sa prst či hrot pera dotkne povrchu. Stav ťahania aktualizuj iba pri udalostiach pointermove s týmto identifikátorom. pointermove môže oznámiť zmenu polohy alebo inej vlastnosti, napríklad tlaku, a môže nastať aj bez kontaktu či stlačeného tlačidla.

Zavolaj element.setPointerCapture(pointerId), aby si mohol sledovať ťahanie aj mimo prvku. Priamy dotyk môže nastaviť zachytenie implicitne. Ak treba zachytenie uvoľniť skôr, použi releasePointerCapture(). Obe metódy môžu vyvolať NotFoundError, ak identifikátor nezodpovedá aktívnemu ukazovateľu.

Potvrď výsledok pri pointerup: prst či pero sa zdvihne alebo sa uvoľní posledné držané tlačidlo myši. Na rozdiel od mousedown a mouseup sa pointerdown a pointerup nespúšťajú pri každej zmene stavu tlačidla. Pri pointercancel zahoď dočasný stav: prehliadač prerušil interakciu, napríklad aby prevzal gesto posúvania alebo približovania.

V oboch prípadoch vymaž uložený identifikátor, aby automatické uvoľnenie zachytenia po pointerup alebo pointercancel neukončilo ťahanie druhýkrát. lostpointercapture oznamuje stratu zachytenia, nie nevyhnutne koniec kontaktu. Preruš ťahanie len vtedy, ak ešte prebieha a udalosť má rovnaký identifikátor.

Zachytenie neblokuje gestá prehliadača: nastav ich spracovanie vopred pomocou CSS vlastnosti touch-action a obmedz none na potrebnú oblasť. Tieto API patria k webovej platforme, nie k ECMAScriptu 2024; dostupnosť závisí od prostredia vykonávania.

Príklady

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

Výsledok

pointerdown
pointermove
pointerup: commit

Ulož príklad ako súbor HTML, otvor ho v prehliadači a sleduj vývojársku konzolu. Začni ťahať hlavným tlačidlom myši vnútri rámčeka a uvoľni ho mimo neho bez stlačenia klávesu Shift. Pri ďalšom ťahaní najprv pohni myšou, potom podrž Shift a pokračuj v pohybe bez uvoľnenia tlačidla, aby si otestoval predčasnú stratu zachytenia. Riadok `pointermove` sa zobrazí najviac raz za ťahanie.

Súvisiace lekcie

  • JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3

Zdroje