PointerEvent: свойство isPrimary

Чтение-только свойство isPrimary интерфейса PointerEvent указывает, является ли устройство указателя, которое создало событие, главным указателем. Оно возвращает true если указатель, вызвавший событие, является основным, и возвращает false в противном случае.

В многоуказательной ситуации (например, на сенсорном экране, поддерживающем более одной точки касания) это свойство используется для идентификации главного указателя среди набора активных указателей для каждого типа указателя. Только основной указатель будет генерировать совместимые события мыши. Авторы, желающие взаимодействия только с одним указателем, могут этого добиться, проигнорировав неглавные указатели.

Указатель считается основным, если он представляет устройство мыши. Указатель, представляющий ввод пера, считается основным вводом пера, если его событие pointerdown было отправлено, когда не было других активных указателей, представляющих ввод пера. Указатель, представляющий ввод касания, считается основным вводом касания, если его событие pointerdown было отправлено, когда не было других активных указателей, представляющих ввод касания.

Когда одновременно используются два или более типа устройств указателей, несколько указателей (по одному для каждого pointerType) считаются основными. Например, одновременное перемещение сенсорного контакта и курсора мыши приведет к указателям, которые оба считаются основными. Если существует несколько основных указателей, все эти указатели будут генерировать совместимые события мыши (см. События указателя для получения дополнительной информации о взаимодействии указателя, мыши и касания).

Булево значение, true если указатель для этого события является основным, и возвращает false в противном случае.

Этот пример демонстрирует использование значения isPrimary для вызова соответствующей функции обработки.

target.addEventListener(
  "pointerdown",
  (event) => {
    if (event.isPrimary) {
      process_primary_pointer(event);
    } else {
      process_secondary_pointer(event);
    }
  },
  false,
);