База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Плъзгане с прихванат указател: потвърждаване или възстановяване на стойността

Дръж временния изглед отделно от потвърдената стойност и приключвай плъзгането само веднъж, дори ако прихващането се загуби след отпускането.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Разглеждай плъзгането с прихванат указател като транзакция. При pointerdown запази началната стойност и pointerId, след което извикай element.setPointerCapture(event.pointerId), за да получава елементът следващите събития от този указател дори извън границите си. Съответстващите събития pointermove обновяват само временния изглед. Движение е възможно и без контакт или натиснат бутон. pointermove може да отчете например промяна на натиска, а браузърът може да обедини няколко измервания в едно събитие.

Потвърди временната стойност само при pointerup. Възстанови началната стойност при pointercancel, например когато браузърът поеме жеста за превъртане, или при lostpointercapture, ако плъзгането още е активно. В общата функция за приключване провери идентификатора и изчисти активното състояние, преди да потвърдиш или възстановиш стойността. Така загубата на прихващането след pointerup или pointercancel не променя резултата повторно. Загубата на прихващане не означава, че указателят е бил освободен.

Прякото докосване може да задейства неявно прихващане. setPointerCapture() хвърля NotFoundError, ако идентификаторът не отговаря на активен указател. Можеш да освободиш прихващането по-рано с releasePointerCapture(); браузърът го освобождава автоматично след pointerup или pointercancel. Задай CSS свойството touch-action преди жеста и ограничи touch-action: none до нужната област, защото може да блокира увеличаването чрез докосване.

Тези събития използват уеб API PointerEvent на браузъра и не изискват ECMAScript 2024. При пръст или връх на писалка pointerdown и pointerup отбелязват началото и края на контакта. При мишка те отчитат натискането на първия и отпускането на последния бутон, а не всяко отделно натискане или отпускане като mousedown и mouseup.

Примери

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

Резултат

pointerdown
pointermove
pointerup
lostpointercapture

Изпълни примера с Node.js и Playwright според указанията за проверка. Playwright натиска бутона в панела, премества мишката извън него и отпуска бутона там. Записва се само първото съответстващо движение. Очакваният изход показва нормално завършване, а не отмяна или преждевременна загуба на прихващане.

Свързани уроци

  • JavaScript · Урок 35 · Напреднало · Версия: 4

Източници