База знанияИзпитен център
BGБългарски
Избери език13

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-only

pointerId е числов идентификатор само за четене. С него свързваш събитията на един и същ активен указател и го различаваш от другите активни указатели, например от втора точка на докосване. Това не е постоянен идентификатор на устройство: не извеждай типа на устройството от числото и не приемай, че то ще остане същото при отделни взаимодействия или че никога няма да се използва повторно. При събития, генерирани от браузъра, -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

Източници