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

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

BCD tables only load in the browser