CKTIS / JavaScript
PointerEvent: identifikátor ukazatele a souřadnice ve výřezu
`pointerId` rozlišuje současně aktivní ukazatele, zatímco `clientX` a `clientY` udávají polohu události ve výřezu v pixelech CSS.
Verze: Current web platform; runtime support varies
Syntaxe
event.pointerId
event.clientX
event.clientYpointerId, clientX a clientY jsou vlastnosti instance PointerEvent určené jen pro čtení. pointerId je číselný identifikátor, který odlišuje ukazatel od ostatních současně aktivních ukazatelů, například dva prsty na obrazovce. Po skončení interakce lze identifikátor použít znovu. Nepoužívej ho jako trvalý identifikátor zařízení ani z něj neodvozuj typ zařízení. U události vytvořené prohlížečem znamená -1, že ji nevyvolalo polohovací zařízení, například při aktivaci tlačítka klávesnicí.
clientX (vodorovná) a clientY (svislá) se dědí z MouseEvent, a to i pro dotykový vstup a vstup perem. Udávají polohu události v pixelech CSS od levého horního rohu výřezu (viewportu) a rostou doprava, respektive dolů. Na rozdíl od pageX a pageY se nevztahují k dokumentu. Nevztahují se ani k cílovému prvku nebo obrazovce. Posouvání dokumentu mění souřadnice pevného bodu dokumentu ve výřezu, nikoli počátek souřadnic výřezu.
Pokud sleduješ více interakcí, ulož při pointerdown počáteční polohu do Map pod klíčem pointerId. Při pointermove vyhledej tento klíč a událost ignoruj, pokud záznam neexistuje. Záznam odstraň při pointerup i při pointercancel. PointerEvent a vlastnosti souřadnic zděděné z MouseEvent patří do API webové platformy. Tyto vlastnosti ani příklad nevyžadují ECMAScript 2024. Dostupnost API závisí na běhovém prostředí.
Pří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ýsledek
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Spusť kód v Node.js nebo v konzoli prohlížeče. Pokud `PointerEvent` není k dispozici, kód předá stejným obslužným funkcím obyčejné objekty `Event` se třemi poli. Syntetické události mají `isTrusted === false` a nepohybují skutečným ukazatelem. Kód vypíše posun od začátku každé interakce. Pohyb ukazatele `8` po zrušení se ignoruje; `tracked=0` znamená, že nezůstal žádný záznam.
Související lekce
- JavaScript · Lekce 35 · Pokročilá · Verze: 4