Spec-Zone.ru › Web APIs

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

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

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

  • Узнать больше
  • Показать полную совместимость
  • Отправить отзыв

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

Примечание: Для браузеров с сенсорным вводом, которые поддерживают прямое управление, событие pointerdown запускает неявное захват указателя, что приводит к тому, что целевой объект захватывает все последующие события указателя, как будто они происходят над захваченным целевым объектом. Соответственно, pointerover, pointerenter, pointerleave, и pointerout не будут срабатывать до тех пор, пока этот захват установлен. Захват можно отключить вручную, вызвав element.releasePointerCapture на целевом элементе, или он будет неявным образом отключен после события pointerup или pointercancel.

Синтаксис

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

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

onpointerdown = (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 Только для чтения

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

Примеры

Использование 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

См. также

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

    • gotpointercapture
    • lostpointercapture
    • pointerover
    • pointerenter
    • 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/pointerdown_event

Spec-Zone.ru

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