CKTIS / JavaScript
PointerEvent: identifikator kazalca in koordinate vidnega polja
`pointerId` loči hkrati dejavne kazalce, `clientX` in `clientY` pa podata položaj dogodka v vidnem polju v slikovnih pikah CSS.
Različica: Current web platform; runtime support varies
Sintaksa
event.pointerId
event.clientX
event.clientYpointerId, clientX in clientY so lastnosti primerka PointerEvent, namenjene samo branju. pointerId je številski identifikator, ki kazalec loči od drugih hkrati dejavnih kazalcev, na primer pri dotiku zaslona z dvema prstoma. Po koncu interakcije se identifikator lahko znova uporabi. Ne uporabljaj ga kot trajni identifikator naprave in iz njega ne sklepaj o vrsti naprave. Pri dogodkih, ki jih ustvari brskalnik, -1 pomeni, da dogodka ni sprožila kazalna naprava, na primer ko gumb aktiviraš s tipkovnico.
clientX (vodoravna) in clientY (navpična) sta podedovani iz MouseEvent tudi pri vnosu z dotikom ali pisalom. Podajata položaj dogodka v slikovnih pikah CSS glede na zgornji levi kot vidnega polja (viewport); vrednosti naraščata proti desni oziroma navzdol. V nasprotju s pageX in pageY se ne nanašata na dokument. Prav tako se ne nanašata na ciljni element ali zaslon. Drsenje po dokumentu spremeni koordinati stalne točke dokumenta v vidnem polju, ne pa izhodišča vidnega polja.
Če slediš več interakcijam, ob pointerdown shrani začetni položaj v Map, kjer je ključ pointerId. Ob pointermove poišči ta ključ in prezri dogodek, če vnosa ni. Vnos izbriši ob pointerup ali pointercancel. PointerEvent in lastnosti koordinat, podedovane iz MouseEvent, spadajo med API-je spletne platforme. Niti te lastnosti niti primer ne zahtevajo ECMAScripta 2024. Razpoložljivost API-jev je odvisna od izvajalnega okolja.
Primeri
(() => {
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}`);
})();Rezultat
7: dx=12, dy=-5 8: dx=-3, dy=9 tracked=0
Kodo zaženi v Node.js ali v konzoli brskalnika. Če `PointerEvent` ni na voljo, koda istim poslušalcem posreduje navadne objekte `Event` s tremi polji. Sintetični dogodki imajo `isTrusted === false` in ne premaknejo dejanskega kazalca. Koda izpiše premik od začetka vsake interakcije. Premik kazalca `8` po preklicu se prezre; `tracked=0` pomeni, da ni več vnosov.
Povezane lekcije
- JavaScript · Lekcija 35 · Napredna · Različica: 4