Touch

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

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

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

Конструктор

Touch() (en-US)
Создаёт объект Touch.

Свойства

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

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

Touch.identifier (en-US) Только для чтения
Возвращает уникальный идентификатор указанного объекта Touch. Данная точка касания (например, пальцем) будет иметь один и тот же идентификатор на протяжении всего движения по сенсорной поверхности. Это гарантирует, что вы всё время отслеживаете одно и то же касание.
Touch.screenX (en-US) Только для чтения
Возвращает координату X точки касания относительно левого края экрана.
Touch.screenY (en-US) Только для чтения
Возвращает координату Y точки касания относительно верхнего края экрана.
Touch.clientX (en-US) Только для чтения
Возвращает координату X точки касания относительно левого края окна браузера, не учитывая прокрутку.
Touch.clientY (en-US) Только для чтения
Возвращает координату Y точки касания относительно верхнего края окна браузера, не учитывая прокрутку.
Touch.pageX (en-US) Только для чтения
Возвращает координату X точки касания относительно левого края документа. В отличие от clientX, это значение учитывает горизонтальную прокрутку, если она есть.
Touch.pageY (en-US) Только для чтения
Возвращает координату Y точки касания относительно верхнего края документа. В отличие от clientY, это значение учитывает вертикальную прокрутку, если она есть.
Touch.target (en-US) Только для чтения
Возвращает элемент (Element), на который попала точка касания, когда впервые появилась на сенсорной поверхности, даже если потом она была смещена за пределы данного элемента или даже была удалена из документа.

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

Experimental

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

Touch.radiusX (en-US) Только для чтения
Возвращает радиус эллипса по оси X, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и screenX.
Touch.radiusY (en-US) Только для чтения
Возвращает радиус эллипса по оси Y, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и screenY.
Touch.rotationAngle (en-US) Только для чтения
Возвращает угол (в градусах), на который описываемый эллипс должен быть повёрнут по часовой стрелке, чтобы наиболее точно покрыть область контакта пользователя с сенсорной поверхностью.
Touch.force (en-US)Только для чтения
Возвращает силу давления пользователем на сенсорную поверхность. Является числом от 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

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