CKTIS / JavaScript
PointerEvent: идентификатор и основен указател
`pointerId` свързва събитията на един и същ активен указател, а `isPrimary` показва дали той е основен за своя тип вход.
Версия: Current web platform; runtime support varies
Синтаксис
// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId // number, read-only
event.isPrimary // boolean, read-onlypointerId е числов идентификатор само за четене. С него свързваш събитията на един и същ активен указател и го различаваш от другите активни указатели, например от втора точка на докосване. Това не е постоянен идентификатор на устройство: не извеждай типа на устройството от числото и не приемай, че то ще остане същото при отделни взаимодействия или че никога няма да се използва повторно. При събития, генерирани от браузъра, -1 означава, че събитието не е предизвикано от посочващо устройство, например при click от клавиатурата.
isPrimary е булево свойство само за четене. Стойността true означава основния указател за съответния pointerType, а не основния бутон. Указателят на мишката е основен; при докосване и писалка основен е първият указател от съответния тип, който става активен, когато няма друг активен указател от същия тип. Затова мишка и докосване могат едновременно да имат isPrimary === true. Когато основното докосване приключи, друго все още активно докосване не става автоматично основно.
За да следиш няколко жеста, при pointerdown запази състоянието в Map с ключ pointerId, при pointermove го намери, а при pointerup или pointercancel го премахни. Ако ти трябва само един указател общо за всички типове вход, запомни избрания идентификатор: филтриране само по isPrimary не е достатъчно. Тези свойства са част от уеб API, а не от ECMAScript; провери поддръжката в целевата среда.
Примери
<!doctype html>
<meta charset="utf-8">
<title>PointerEvent example</title>
<pre id="output"></pre>
<script>
const events = [
new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 7, isPrimary: true }),
new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 8, isPrimary: false }),
new PointerEvent("pointermove", { pointerType: "touch", pointerId: 7, isPrimary: true }),
new PointerEvent("pointermove", { pointerType: "mouse", pointerId: 12, isPrimary: true }),
];
const lines = [];
for (const event of events) {
lines.push(`${event.type} ${event.pointerType} ${event.pointerId} ${event.isPrimary}`);
}
document.getElementById("output").textContent = lines.join("\n");
</script>Резултат
pointerdown touch 7 true pointerdown touch 8 false pointermove touch 7 true pointermove mouse 12 true
Запази примера като HTML файл и го отвори в браузър с поддръжка на `PointerEvent`. Резултатът се показва на страницата. Идентификаторът `7` свързва две събития от докосване, `8` означава друго докосване, а и мишката, и първото докосване имат стойност `true`. Кодът чете изрично зададени стойности от синтетични събития. Той не изпраща събитията и не проверява как браузърът задава стойности при реален вход.
Свързани уроци
- JavaScript · Урок 35 · Средно · Версия: 3