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
Touch Events # touch-interface

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

BCD tables only load in the browser