Spec-Zone.ru › Web APIs

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

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2020 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие gotpointercapture срабатывает, когда элемент захватывает указатель с помощью setPointerCapture().

Синтаксис

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

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

ongotpointercapture = (event) => {};

Тип события

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

Событие UIEvent MouseEvent PointerEvent

Свойства события

Этот интерфейс наследует свойства от 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 Только для чтения

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

Примеры

В этом примере берется элемент <p> и добавляется обработчик события gotpointercapture. Затем вызывается setPointerCapture() на элементе при событии pointerdown, что вызовет gotpointercapture.

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

para.addEventListener("gotpointercapture", () => {
  console.log("I've been captured!");
});

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Тот же пример, но с использованием свойства обработчика события ongotpointercapture:

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

para.ongotpointercapture = () => {
  console.log("I've been captured!");
};

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

Спецификации

Спецификация
Pointer Events
# the-gotpointercapture-event
Pointer Events
# dom-globaleventhandlers-ongotpointercapture

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
gotpointercapture_event 57 17 59 44 13 57 79 43 13 7.0 57

См. также

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

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/gotpointercapture_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API