Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Tažení se zachycením ukazatele: potvrzení nebo obnovení hodnoty

Oddělte náhled od potvrzené hodnoty a ukončete tažení jen jednou, i když ztráta zachycení nastane až po uvolnění ukazatele.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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

Při tažení se zachycením ukazatele zacházejte se změnou jako s transakcí. Při pointerdown uložte počáteční hodnotu a pointerId a zavolejte element.setPointerCapture(event.pointerId). Další události daného ukazatele pak míří na prvek i mimo jeho hranice. Odpovídající události pointermove mění jen náhled. Pohyb může nastat i bez kontaktu nebo stisknutého tlačítka. pointermove může hlásit třeba změnu přítlaku a prohlížeč může sloučit několik vzorků do jedné události.

Náhled potvrďte jen při pointerup. Počáteční hodnotu obnovte při pointercancel, například když prohlížeč převezme gesto pro posouvání stránky, nebo při lostpointercapture, pokud tažení ještě probíhá. Ve společné dokončovací funkci ověřte identifikátor a zrušte aktivní stav ještě před potvrzením nebo obnovením hodnoty. Ztráta zachycení po pointerup či pointercancel pak výsledek nezmění podruhé. Ztráta zachycení neznamená uvolnění ukazatele.

Přímý dotyk může vyvolat implicitní zachycení. setPointerCapture() vyvolá výjimku NotFoundError, pokud identifikátor neodpovídá aktivnímu ukazateli. Zachycení můžete uvolnit dříve pomocí releasePointerCapture(); po pointerup nebo pointercancel ho prohlížeč uvolní automaticky. Vlastnost CSS touch-action nastavte před gestem a touch-action: none omezte na potřebnou oblast, protože může znemožnit přiblížení dotykem.

Tyto události používají webové API PointerEvent prohlížeče a nevyžadují ECMAScript 2024. U prstu nebo hrotu pera označují pointerdown a pointerup začátek a konec kontaktu. U myši hlásí stisk prvního a uvolnění posledního tlačítka, nikoli každý jednotlivý stisk nebo uvolnění jako mousedown a mouseup.

Příklady

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

Výsledek

pointerdown
pointermove
pointerup
lostpointercapture

Spusťte příklad v Node.js s Playwrightem podle pokynů k ověření. Playwright stiskne tlačítko uvnitř panelu, přesune myš ven a tam tlačítko uvolní. Zaznamená se jen první odpovídající pohyb. Očekávaný výstup ukazuje běžné dokončení, nikoli zrušení nebo předčasnou ztrátu zachycení.

Související lekce

  • JavaScript · Lekce 35 · Pokročilá · Verze: 4

Zdroje