Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Przechwycenie wskaźnika przy przeciąganiu: zatwierdzenie i przerwanie

Śledź jedno przeciąganie według `pointerId` i zakończ je tylko raz: zatwierdź wynik po zwolnieniu wskaźnika albo odrzuć go po anulowaniu lub przedwczesnej utracie przechwycenia.

Wersja: Current web platform; runtime support varies

Składnia

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

Zacznij od zapisania pointerId zaakceptowanego w pointerdown. To zdarzenie oznacza naciśnięcie pierwszego przycisku myszy albo kontakt palca lub końcówki pióra. Aktualizuj stan przeciągania tylko dla zdarzeń pointermove o zapisanym identyfikatorze. pointermove może sygnalizować zmianę pozycji lub innej właściwości, np. nacisku; może też wystąpić bez naciśniętego przycisku.

Aby śledzić przeciąganie także poza elementem, wywołaj element.setPointerCapture(pointerId). Bezpośredni dotyk może uruchomić przechwycenie niejawnie. Jeśli trzeba zwolnić przechwycenie wcześniej, użyj releasePointerCapture(). Obie metody mogą zgłosić NotFoundError, jeśli identyfikator nie odpowiada aktywnemu wskaźnikowi.

Zatwierdź wynik po pointerup: palec lub pióro odrywa się albo zostaje zwolniony ostatni wciśnięty przycisk myszy. W przeciwieństwie do mousedown i mouseup zdarzenia pointerdown i pointerup nie występują dla każdej zmiany stanu przycisku. Po pointercancel odrzuć stan tymczasowy: przeglądarka przerwała interakcję, np. przejmując gest przewijania lub powiększania.

W obu przypadkach wyczyść zapisany identyfikator, aby automatyczne zwolnienie przechwycenia po pointerup lub pointercancel nie zakończyło operacji po raz drugi. lostpointercapture oznacza utratę przechwycenia, a niekoniecznie zakończenie kontaktu. Przerwij przeciąganie tylko wtedy, gdy nadal trwa i zdarzenie dotyczy zapisanego identyfikatora.

Przechwycenie nie blokuje gestów przeglądarki: określ je zawczasu za pomocą CSS touch-action i ogranicz none do niezbędnego obszaru. To API platformy webowej, a nie część ECMAScript 2024; dostępność zależy od środowiska wykonawczego.

Przykłady

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

Wynik

pointerdown
pointermove
pointerup: commit

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i obserwuj konsolę deweloperską. Zacznij przeciąganie przyciskiem głównym myszy w polu i zwolnij go poza polem bez naciskania Shift. Przy kolejnym przeciąganiu, po rozpoczęciu ruchu, przytrzymaj Shift i poruszaj dalej bez zwalniania przycisku, aby sprawdzić wcześniejszą utratę przechwycenia. Wiersz `pointermove` pojawia się najwyżej raz na przeciągnięcie.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3

Źródła