CKTIS / JavaScript
PointerEvent: идентификатор на указателя и координати във видимата област
`pointerId` разграничава едновременно активните указатели, а `clientX` и `clientY` дават координатите на събитието във видимата област в CSS пиксели.
Версия: Current web platform; runtime support varies
Синтаксис
event.pointerId
event.clientX
event.clientYpointerId, clientX и clientY са свойства само за четене на екземпляр на PointerEvent. pointerId е числов идентификатор, който отличава даден указател от другите едновременно активни указатели, например при докосване на екрана с два пръста. Идентификаторът може да се използва повторно след края на взаимодействието. Не го използвай като постоянен идентификатор на устройство и не определяй типа на устройството по него. При събития, генерирани от браузъра, -1 означава, че събитието не идва от посочващо устройство, например когато бутон се активира с клавиатурата.
clientX (хоризонтална) и clientY (вертикална) се наследяват от MouseEvent дори при въвеждане чрез докосване или писалка. Те определят позицията на събитието в CSS пиксели спрямо горния ляв ъгъл на видимата област (viewport) и нарастват съответно надясно и надолу. За разлика от pageX и pageY, те не са спрямо документа. Не са и спрямо целевия елемент или екрана. Превъртането на документа променя координатите на неподвижна точка от документа във видимата област, но не и началото на координатната ѝ система.
За да проследиш няколко взаимодействия, при pointerdown запази началната позиция в Map с ключ pointerId. При pointermove потърси този ключ и пропусни събитието, ако няма запис. Изтрий записа както при pointerup, така и при pointercancel. PointerEvent и свойствата за координати, наследени от MouseEvent, са част от API на уеб платформата. Нито тези свойства, нито примерът изискват ECMAScript 2024. Наличността на тези API зависи от средата за изпълнение.
Примери
(() => {
const target = new EventTarget();
const starts = new Map();
target.addEventListener("pointerdown", ({ pointerId, clientX, clientY }) => {
starts.set(pointerId, { x: clientX, y: clientY });
});
target.addEventListener("pointermove", ({ pointerId, clientX, clientY }) => {
const start = starts.get(pointerId);
if (!start) return;
console.log(`${pointerId}: dx=${clientX - start.x}, dy=${clientY - start.y}`);
});
const end = ({ pointerId }) => { starts.delete(pointerId); };
target.addEventListener("pointerup", end);
target.addEventListener("pointercancel", end);
const send = (type, pointerId, clientX, clientY) => {
const fields = { pointerId, clientX, clientY };
// Without PointerEvent, use a plain Event to exercise the same listeners.
const event = typeof PointerEvent === "function"
? new PointerEvent(type, fields)
: Object.assign(new Event(type), fields);
target.dispatchEvent(event);
};
send("pointerdown", 7, 100, 80);
send("pointerdown", 8, 200, 150);
send("pointermove", 7, 112, 75);
send("pointermove", 8, 197, 159);
send("pointercancel", 8, 197, 159);
send("pointermove", 8, 198, 160);
send("pointerup", 7, 112, 75);
console.log(`tracked=${starts.size}`);
})();Резултат
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Изпълни кода в Node.js или в конзолата на браузър. Ако `PointerEvent` не е наличен, кодът подава обикновени обекти `Event` с трите полета на същите обработчици. Синтетичните събития имат `isTrusted === false` и не местят реален указател. Кодът извежда отместването спрямо началото на всяко взаимодействие. Движението на указател `8` след отмяната се пропуска; `tracked=0` означава, че няма останали записи.
Свързани уроци
- JavaScript · Урок 35 · Напреднало · Версия: 4