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

CKTIS / JavaScript

PointerEvent — събития за показалец и прихващане

PointerEvent обединява входа от мишка, докосване и писалка. Научете как идентификаторите на показалеца, координатите на видимата област, жизненият цикъл на взаимодействието и прихващането работят заедно при реализиране на плъзгане.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new PointerEvent(type, options)
element.addEventListener('pointerdown', handler)
element.setPointerCapture(event.pointerId)
element.releasePointerCapture(event.pointerId)

PointerEvent е интерфейс на уеб API на браузъра, който наследява MouseEvent и обединява входа от мишка, докосване и писалка. Това не е функция на конкретно издание на ECMAScript. Проверете наличността с 'PointerEvent' in window; наличието на Node 24 в хранилище не доказва поддръжка от браузъра.

PointerEvent.pointerId идентифицира активен показалец; идентификаторите могат да бъдат използвани повторно по-късно и не са постоянни идентификатори на устройства. PointerEvent.isPrimary обозначава основния показалец от съответния тип, а не един-единствен глобален показалец. Следователно мишката и докосването могат едновременно да имат по един основен показалец. PointerEvent.clientX и PointerEvent.clientY, наследени от MouseEvent, предоставят координати спрямо видимата област в CSS пиксели, а не координати спрямо елемента или началото на документа.

Цикълът на взаимодействието включва pointerdown, pointermove и приключване чрез pointerup или pointercancel. Изчиствайте състоянието на взаимодействието и при отмяна, например когато браузърът поеме управлението на жест. pointerover/pointerout и pointerenter/pointerleave описват границите на елементите; те не заместват приключването на взаимодействието.

Извикването на element.setPointerCapture(event.pointerId) по време на реално pointerdown насочва следващите събития за този показалец към елемента, дори извън неговите граници. gotpointercapture и lostpointercapture съобщават за придобиването и загубата на прихващане; element.releasePointerCapture(event.pointerId) го освобождава изрично. Освобождаване настъпва и след pointerup или pointercancel. Входът чрез докосване може да получи прихващане по подразбиране. Обработвайте загубата на прихващане, за да не остане плъзгането активно.

За персонализирани жестове задайте подходящия CSS touch-action, преди взаимодействието да започне; само preventDefault() не блокира преместването и мащабирането на видимата област. Примерът умишлено изпраща синтетични събития: проверява свойствата и изчистването на състоянието, но не задейства реален хардуерен вход или прихващане на показалеца.

Примери

const target = document.createElement('div');
const active = new Map();
const lines = [];

for (const type of ['pointerdown', 'pointermove', 'pointerup', 'pointercancel']) {
  target.addEventListener(type, (event) => {
    const { pointerId, isPrimary, clientX, clientY } = event;
    if (type === 'pointerdown') active.set(pointerId, true);
    if (!active.has(pointerId)) return;
    lines.push(`${type} ${pointerId} ${isPrimary} ${clientX},${clientY}`);
    if (type === 'pointerup' || type === 'pointercancel') {
      active.delete(pointerId);
    }
  });
}

for (const [type, clientX, clientY] of [
  ['pointerdown', 10, 20],
  ['pointermove', 15, 25],
  ['pointerup', 15, 25]
]) {
  target.dispatchEvent(new PointerEvent(type, {
    pointerId: 7, pointerType: 'touch', isPrimary: true,
    clientX, clientY
  }));
}
console.log(lines.join('\n'));
console.log(`active=${active.size}`);

Резултат

pointerdown 7 true 10,20
pointermove 7 true 15,25
pointerup 7 true 15,25
active=0

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници