Элемент: событие pointerdown
Базовая линия Широко поддерживается
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2020 года.
Событие pointerdown срабатывает, когда указатель становится активным. Для мыши оно срабатывает, когда устройство переходит от состояния без нажатых кнопок к состоянию с хотя бы одной нажатой кнопкой. Для сенсорного ввода оно срабатывает при физическом контакте с цифровым стилусом. Для пера оно срабатывает, когда стилус физически контактирует с цифровым стилусом.
Примечание: Для браузеров с сенсорным вводом, которые поддерживают прямое управление, событие pointerdown запускает неявное захват указателя, что приводит к тому, что целевой объект захватывает все последующие события указателя, как будто они происходят над захваченным целевым объектом. Соответственно, pointerover, pointerenter, pointerleave, и pointerout не будут срабатывать до тех пор, пока этот захват установлен. Захват можно отключить вручную, вызвав element.releasePointerCapture на целевом элементе, или он будет неявным образом отключен после события pointerup или pointercancel.
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика события.
addEventListener("pointerdown", (event) => {});
onpointerdown = (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("pointerdown", (event) => {
console.log("Pointer down event");
});
Использование свойства обработчика события onpointerdown:
const para = document.querySelector("p");
para.onpointerdown = (event) => {
console.log("Pointer down event");
};
Спецификации
| Спецификация |
|---|
| Pointer Events # the-pointerdown-event |
| Pointer Events # dom-globaleventhandlers-onpointerdown |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
pointerdown_event |
55 | 1212–79 | 59 | 42 | 13 | 55 | 79 | 42 | 13 | 6.0 | 55 |
См. также
© 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/pointerdown_event