Touch

Интерфейс 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 Status Comment
Touch Events – Level 2
Определение 'Touch' в этой спецификации.
Черновик Добавлены свойства radiusX, radiusY, rotationAngle, force, и также конструктор Touch().
Touch Events
Определение 'Touch' в этой спецификации.
Рекомендация Исходное определение.

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

BCD tables only load in the browser

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