Элемент: событие pointercancel

Событие pointercancel срабатывает, когда браузер определяет, что вряд ли появятся другие события pointer, или если после события pointerdown указатель используется для управления просмотром путём масштабирования, изменения масштаба или прокрутки.

Вот некоторые примеры ситуаций, которые приведут к срабатыванию события pointercancel:

• Происходит аппаратное событие, которое отменяет действия указателя. Это может включать, например, переключение пользователем приложений с помощью интерфейса переключения приложений или кнопки «Домой» на мобильном устройстве.
• Изменяется ориентация экрана устройства, пока указатель активен.
• Браузер решает, что пользователь случайно начал ввод указателя. Это может произойти, например, если оборудование поддерживает отказ от распознавания ладони, чтобы предотвратить случайное срабатывание событий, когда рука лежит на дисплее при использовании стилуса.
• Свойство CSS touch-action предотвращает продолжение ввода.
• При взаимодействии пользователя с слишком многими одновременными указателями браузер может генерировать это событие для всех существующих указателей (даже если пользователь по-прежнему касается экрана).

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

addEventListener("pointercancel", (event) => {});

onpointercancel = (event) => {};

Объект PointerEvent. Наследует от Event.

Этот интерфейс наследует свойства от MouseEvent и Event.

PointerEvent.altitudeAngle Только для чтения Экспериментальный

Представляет угол между осью преобразователя (указателя или стилуса) и плоскостью X-Y экрана устройства.

PointerEvent.azimuthAngle Только для чтения Экспериментальный

Представляет угол между плоскостью Y-Z и плоскостью, содержащей ось преобразователя (указателя или стилуса) и ось Y.

PointerEvent.persistentDeviceId Только для чтения Экспериментальный

Уникальный идентификатор устройства указания, генерирующего событие PointerEvent.

PointerEvent.pointerId Только для чтения

Уникальный идентификатор указателя, вызвавшего событие.

PointerEvent.width Только для чтения

Ширина (величина по оси X) геометрии контакта указателя в пикселях CSS.

PointerEvent.height Только для чтения

Высота (величина по оси Y) геометрии контакта указателя в пикселях CSS.

PointerEvent.pressure Только для чтения

Нормализованное давление ввода указателя в диапазоне 0 до 1, где 0 и 1 представляют собой минимальное и максимальное давление соответственно, которое оборудование способно обнаружить.

PointerEvent.tangentialPressure Только для чтения

Нормализованное тангенциальное давление ввода указателя (также известное как бочкообразное давление или цилиндрическое напряжение) в диапазоне -1 до 1, где 0 — нейтральное положение управления.

PointerEvent.tiltX Только для чтения

Угол в плоскости (в градусах, в диапазоне от -90 до 90) между плоскостью Y-Z и плоскостью, содержащей ось указателя (например, стилуса) и ось Y.

PointerEvent.tiltY Только для чтения

Угол в плоскости (в градусах, в диапазоне от -90 до 90) между плоскостью X-Z и плоскостью, содержащей ось указателя (например, стилуса) и ось X.

PointerEvent.twist Только для чтения

Поворот указателя (например, стилуса) по часовой стрелке вокруг его главной оси в градусах, со значением в диапазоне 0 до 359.

PointerEvent.pointerType Только для чтения

Указывает тип устройства, вызвавшего событие (мышь, ручка, сенсорный ввод и т. д.).

PointerEvent.isPrimary Только для чтения

Указывает, является ли указатель основным указателем данного типа указателей.

Использование addEventListener():

const para = document.querySelector("p");

para.addEventListener("pointercancel", (event) => {
  console.log("Pointer event cancelled");
});

Использование свойства обработчика события onpointercancel:

const para = document.querySelector("p");

para.onpointercancel = (event) => {
  console.log("Pointer event cancelled");
};

• Связанные события

  • gotpointercapture
  • lostpointercapture
  • pointerover
  • pointerenter
  • pointerdown
  • pointermove
  • pointerup
  • pointerout
  • pointerleave
  • pointerrawupdate