This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

TouchEvent.touches

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

touches это доступный только для чтения список TouchList, в котором перечислены все объекты Touch для точек контакта с сенсорной поверхностью, независимо от того, изменились ли они и какой целевой элемент был у них во время события touchstart.

Вы можете воспринимать это как перечисление отдельных пальцев, которые могут быть идентифицированы при касании экрана.

Синтаксис

var touches = touchEvent.touches;

Возвращаемое значение

touches

Список TouchList всех объектов Touch для точек контакта с сенсорной поверхностью, независимо от того, изменились ли они и какой целевой элемент был у них во время события touchstart.

Пример

Этот пример демонстрирует свойство TouchEvent.touches объекта TouchEvent. Свойство TouchEvent.touches это объект TouchList, который содержит список объектов Touch для каждой активной точки контакта с сенсорной поверхностью.

В следующем фрагменте кода обработчик события touchstart проверяет длину списка TouchEvent.touches для определения количества точек касаний, которые были активированы, а затем вызывает разные обработчики в зависимости от количества таких точек.

js
someElement.addEventListener(
  "touchstart",
  function (e) {
    // Вызов определённого обработчика, в зависимости от
    // количества точек касания
    switch (e.touches.length) {
      case 1:
        handle_one_touch(e);
        break;
      case 2:
        handle_two_touches(e);
        break;
      case 3:
        handle_three_touches(e);
        break;
      default:
        console.log("Not supported");
        break;
    }
  },
  false,
);

Спецификации

Specification
Touch Events
# dom-touchevent-touches

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