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`), на который попала точка касания, когда впервые появилась на сенсорной поверхности, даже если потом она была смещена за пределы данного элемента или даже была удалена из документа.

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

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

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

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

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

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

* `Touch Events Overview`
* `Document.createTouch()` (en-US)