Touch

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Интерфейс Touch представляет определённую точку касания на сенсорном устройстве. Точка касания – это место контакта пальца или стилуса с сенсорной поверхностью тачскрина или трекпада.

Свойства Touch.radiusX, Touch.radiusY, и Touch.rotationAngle содержат данные об области контакта между пользователем и экраном – области касания. Они могут быть полезны при работе с устройствами, предусматривающими указатели низкой точности, например палец. Эти значения описывают эллипс, который соответствует области контакта (например, кончик пальца пользователя). Экспериментальная возможность

Примечание: Многие значения зависят от устройства; например, если устройство не способно измерять силу нажатия на сенсорную поверхность, значение force всегда будет равняться 0. То же касается значений radiusX и radiusY; если у устройства только одна точка касания, данные значения всегда будут равны 1.

Конструктор

Touch() Экспериментальная возможность

Создаёт объект Touch.

Свойства

Данный интерфейс не имеет предков, не наследует и не реализует другие свойства.

Основные свойства

Touch.identifier Только для чтения

Возвращает уникальный идентификатор указанного объекта Touch. Данная точка касания (например, пальцем) будет иметь один и тот же идентификатор на протяжении всего движения по сенсорной поверхности. Это гарантирует, что вы всё время отслеживаете одно и то же касание.

Touch.screenX Только для чтения

Возвращает координату X точки касания относительно левого края экрана.

Touch.screenY Только для чтения

Возвращает координату Y точки касания относительно верхнего края экрана.

Touch.clientX Только для чтения

Возвращает координату X точки касания относительно левого края окна браузера, не учитывая прокрутку.

Touch.clientY Только для чтения

Возвращает координату Y точки касания относительно верхнего края окна браузера, не учитывая прокрутку.

Touch.pageX Только для чтения

Возвращает координату X точки касания относительно левого края документа. В отличие от clientX, это значение учитывает горизонтальную прокрутку, если она есть.

Touch.pageY Только для чтения

Возвращает координату Y точки касания относительно верхнего края документа. В отличие от clientY, это значение учитывает вертикальную прокрутку, если она есть.

Touch.target Только для чтения

Возвращает элемент (Element), на который попала точка касания, когда впервые появилась на сенсорной поверхности, даже если потом она была смещена за пределы данного элемента или даже была удалена из документа.

Область касания

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Touch.radiusX Только для чтения Экспериментальная возможность

Возвращает радиус эллипса по оси X, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и screenX.

Touch.radiusY Только для чтения Экспериментальная возможность

Возвращает радиус эллипса по оси Y, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и screenY.

Touch.rotationAngle Только для чтения Экспериментальная возможность

Возвращает угол (в градусах), на который описываемый эллипс должен быть повёрнут по часовой стрелке, чтобы наиболее точно покрыть область контакта пользователя с сенсорной поверхностью.

Touch.forceТолько для чтения Экспериментальная возможность

Возвращает силу давления пользователем на сенсорную поверхность. Является числом от 0.0 (без давления) до 1.0 (максимальное давление).

Методы

Этот интерфейс не имеет метода и родителя, а также не наследует и не реализует какой-либо метод.

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

Specification
Touch Events
# touch-interface

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Touch
Touch() constructor
altitudeAngle
azimuthAngle
clientX
clientY
force
identifier
pageX
pageY
radiusX
radiusY
rotationAngle
screenX
screenY
target
touchType

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Requires a vendor prefix or different name for use.
Has more compatibility info.

Смотрите также