---
title: Touch
slug: Web/API/Touch
translation_of: Web/API/Touch
---
<p>{{ APIRef("Touch Events") }}</p>

<p><font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">Интерфейс </span></font><code><strong>Touch</strong></code> представляет определённую точку касания на сенсорном устройстве. Точка касания – это место контакта пальца или стилуса с сенсорной поверхностью тачскрина или трекпада.</p>

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

<div class="note">
<p><strong>Примечание:</strong> Многие значения зависят от устройства; например, если устройство не способно измерять силу нажатия на сенсорную поверхность, значение <code>force</code> всегда будет равняться 0. То же касается значений <code>radiusX</code> и <code>radiusY</code>; если у устройства только одна точка касания, данные значения всегда будут равны 1.</p>
</div>

<h2 id="Конструктор">Конструктор</h2>

<dl>
 <dt>{{domxref("Touch.Touch", "Touch()")}} {{experimental_inline}}</dt>
 <dd>Создаёт объект Touch.</dd>
</dl>

<h2 id="Свойства">Свойства</h2>

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

<h3 id="Основные_свойства">Основные свойства</h3>

<dl>
 <dt>{{ domxref("Touch.identifier") }} {{readonlyInline}}</dt>
 <dd>Возвращает уникальный идентификатор указанного объекта <code>Touch</code>. Данная точка касания (например, пальцем) будет иметь один и тот же идентификатор на протяжении всего движения по сенсорной поверхности. Это гарантирует, что вы всё время отслеживаете одно и то же касание.</dd>
 <dt><strong>{{ domxref("Touch.screenX") }} </strong>{{readonlyInline}}</dt>
 <dd>Возвращает координату X точки касания относительно левого края экрана.</dd>
 <dt><strong>{{ domxref("Touch.screenY") }} </strong>{{readonlyInline}}</dt>
 <dd>Возвращает координату Y точки касания относительно верхнего края экрана.</dd>
 <dt><strong>{{ domxref("Touch.clientX") }} </strong>{{readonlyInline}}</dt>
 <dd>Возвращает координату X точки касания относительно левого края окна браузера, не учитывая прокрутку.</dd>
 <dt><strong>{{ domxref("Touch.clientY") }} </strong>{{readonlyInline}}</dt>
 <dd>Возвращает координату Y точки касания относительно верхнего края окна браузера, не учитывая прокрутку.</dd>
 <dt>{{ domxref("Touch.pageX") }} {{readonlyInline}}</dt>
 <dd>Возвращает координату X точки касания относительно левого края документа. В отличие от <code>clientX</code>, это значение учитывает горизонтальную прокрутку, если она есть.</dd>
 <dt>{{ domxref("Touch.pageY") }} {{readonlyInline}}</dt>
 <dd>Возвращает координату Y точки касания относительно верхнего края документа. В отличие от <code>clientY</code>, это значение учитывает вертикальную прокрутку, если она есть.</dd>
 <dt>{{ domxref("Touch.target") }} {{readonlyInline}}</dt>
 <dd>Возвращает элемент ({{ domxref("Element")}}), на который попала точка касания, когда впервые появилась на сенсорной поверхности, даже если потом она была смещена за пределы данного элемента или даже была удалена из документа.</dd>
</dl>

<h3 id="Область_касания">Область касания</h3>

<p>{{SeeCompatTable}}</p>

<dl>
 <dt>{{ domxref("Touch.radiusX") }} {{readonlyInline}} {{experimental_inline}}</dt>
 <dd>Возвращает радиус эллипса по оси X, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и <code>screenX</code>.</dd>
 <dt>{{ domxref("Touch.radiusY") }} {{readonlyInline}} {{experimental_inline}}</dt>
 <dd>Возвращает радиус эллипса по оси Y, наиболее близко соответствующий области контакта с экраном. Значение в пикселях того же масштаба, что и <code>screenY</code>.</dd>
 <dt>{{ domxref("Touch.rotationAngle") }} {{readonlyInline}} {{experimental_inline}}</dt>
 <dd>Возвращает угол (в градусах), на который описываемый эллипс должен быть повёрнут по часовой стрелке, чтобы наиболее точно покрыть область контакта пользователя с сенсорной поверхностью.</dd>
 <dt>{{ domxref("Touch.force") }}{{readonlyInline}} {{experimental_inline}}</dt>
 <dd>Возвращает силу давления пользователем на сенсорную поверхность. Является числом от 0.0 (без давления) до 1.0 (максимальное давление).</dd>
</dl>

<h2 id="Методы">Методы</h2>

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

<dl>
</dl>

<h2 id="Спецификации">Спецификации</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Touch Events 2', '#touch-interface', 'Touch')}}</td>
   <td>{{Spec2('Touch Events 2')}}</td>
   <td>Добавлены свойства <code>radiusX</code>, <code>radiusY</code>, <code>rotationAngle</code>, <code>force</code>, и также конструктор <code>Touch()</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('Touch Events', '#touch-interface', 'Touch')}}</td>
   <td>{{Spec2('Touch Events')}}</td>
   <td>Исходное определение.</td>
  </tr>
 </tbody>
</table>

<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>

<div>


<p>{{Compat("api.Touch")}}</p>
</div>

<h2 id="Смотрите_также">Смотрите также</h2>

<ul>
 <li>{{domxref("Touch_events","Touch Events Overview")}}</li>
 <li>{{ domxref("Document.createTouch()") }}</li>
</ul>

<dl>
</dl>