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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.