Spec-Zone.ru › Web APIs

Элемент: событие touchcancel

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Событие touchcancel срабатывает, когда одно или несколько касаний были прерваны специфичным для реализации способом.

Вот некоторые примеры ситуаций, которые приведут к срабатыванию события touchcancel:

  • Возникает аппаратное событие, которое отменяет действия касания. Это может включать, например, переключение пользователем приложений с помощью интерфейса переключения приложений или кнопки «Домой» на мобильном устройстве.
  • Ориентация экрана устройства изменяется во время активного касания.
  • Браузер определяет, что пользователь случайно начал ввод касанием. Это может произойти, например, если оборудование поддерживает отказ от касания ладонью, чтобы предотвратить случайное срабатывание событий от руки, лежащей на дисплее при использовании стилуса.
  • Свойство CSS touch-action предотвращает продолжение ввода.
  • Когда пользователь взаимодействует слишком многими пальцами одновременно, браузер может сгенерировать это событие для всех существующих указателей (даже если пользователь по-прежнему касается экрана).

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

addEventListener("touchcancel", (event) => {});

ontouchcancel = (event) => {};

Тип события

Объект TouchEvent. Наследуется от Event.

Событие UIEvent TouchEvent

Свойства события

Этот интерфейс наследует свойства от родительского интерфейса UIEvent и Event.

TouchEvent.altKey Только для чтения

Логическое значение, указывающее, была ли нажата клавиша Alt при срабатывании события касания.

TouchEvent.changedTouches Только для чтения

TouchList всех объектов Touch, представляющих отдельные точки контакта, состояние которых изменилось между предыдущим событием касания и текущим.

TouchEvent.ctrlKey Только для чтения

Логическое значение, указывающее, была ли нажата клавиша Ctrl при срабатывании события касания.

TouchEvent.metaKey Только для чтения

Логическое значение, указывающее, была ли нажата клавиша Meta при срабатывании события касания.

TouchEvent.shiftKey Только для чтения

Логическое значение, указывающее, была ли нажата клавиша Shift при срабатывании события касания.

TouchEvent.targetTouches Только для чтения

TouchList всех объектов Touch, которые в настоящее время контактируют с сенсорной поверхностью и были также инициированы на том же элементе, являющимся целевым элементом события.

TouchEvent.touches Только для чтения

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

TouchEvent.rotation Нестандартно Только для чтения

Изменение угла поворота (в градусах) с начала события. Положительные значения указывают поворот по часовой стрелке, отрицательные — против часовой стрелки. Начальное значение: 0.0.

TouchEvent.scale Нестандартно Только для чтения

Расстояние между двумя пальцами с начала события. Выражается как плавающее число, кратное начальному расстоянию между пальцами в начале события. Значения ниже 1,0 указывают на входящее сжатие (уменьшение масштаба). Значения выше 1,0 указывают на выходящее разжатие (увеличение масштаба). Начальное значение: 1.0.

Примеры

Примеры кода для этих событий доступны на отдельной странице: События касания.

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

Спецификация
События касания
# event-touchcancel
События касания
# dom-globaleventhandlers-ontouchcancel

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
touchcancel_event 22 12 52 Нет Нет 25 6 14 ≤3 1.5 4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/touchcancel_event

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API