Элемент: событие gotpointercapture
Базовая Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2020 года.
Событие gotpointercapture срабатывает, когда элемент захватывает указатель с помощью setPointerCapture().
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.
addEventListener("gotpointercapture", (event) => {});
ongotpointercapture = (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Только для чтения -
Указывает, является ли указатель основным указателем этого типа указателя.
Примеры
В этом примере берется элемент <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 |
См. также
© 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