CKTIS / JavaScript
PointerEvent: identifikátor ukazovateľa a súradnice v zobrazovacej oblasti
`pointerId` rozlišuje súčasne aktívne ukazovatele a `clientX` s `clientY` určujú polohu udalosti v zobrazovacej oblasti v pixeloch CSS.
Verzia: Current web platform; runtime support varies
Syntax
event.pointerId
event.clientX
event.clientYpointerId, clientX a clientY sú vlastnosti inštancie PointerEvent určené len na čítanie. pointerId je číselný identifikátor, ktorý odlišuje ukazovateľ od ostatných súčasne aktívnych ukazovateľov, napríklad pri dotyku dvoma prstami na obrazovke. Po skončení interakcie sa identifikátor môže použiť znova. Nepoužívaj ho ako trvalý identifikátor zariadenia ani z neho neodvodzuj typ zariadenia. Pri udalosti vytvorenej prehliadačom -1 znamená, že ju nevyvolalo ukazovacie zariadenie, napríklad pri aktivácii tlačidla klávesnicou.
clientX (vodorovná) a clientY (zvislá) sa dedia z MouseEvent, a to aj pri dotykovom vstupe alebo vstupe perom. Udávajú polohu udalosti v pixeloch CSS od ľavého horného rohu zobrazovacej oblasti (viewportu) a rastú doprava, respektíve nadol. Na rozdiel od pageX a pageY sa nevzťahujú na dokument. Nevzťahujú sa ani na cieľový prvok či obrazovku. Posúvanie dokumentu mení súradnice pevného bodu dokumentu v zobrazovacej oblasti, nie začiatok jej súradnicovej sústavy.
Ak sleduješ viac interakcií, pri pointerdown ulož počiatočnú polohu do Map pod kľúčom pointerId. Pri pointermove vyhľadaj tento kľúč a udalosť ignoruj, ak záznam neexistuje. Záznam odstráň pri pointerup aj pri pointercancel. PointerEvent a vlastnosti súradníc zdedené z MouseEvent patria do API webovej platformy. Tieto vlastnosti ani príklad nevyžadujú ECMAScript 2024. Dostupnosť API závisí od prostredia vykonávania.
Príklady
(() => {
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}`);
})();Výsledok
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Spusť kód v Node.js alebo v konzole prehliadača. Ak `PointerEvent` nie je dostupný, kód odovzdá tým istým obslužným funkciám obyčajné objekty `Event` s tromi poľami. Syntetické udalosti majú `isTrusted === false` a nepohybujú skutočným ukazovateľom. Kód vypíše posun od začiatku každej interakcie. Pohyb ukazovateľa `8` po zrušení sa ignoruje; `tracked=0` znamená, že nezostal žiadny záznam.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Pokročilá · Verzia: 4