Элемент: событие touchcancel
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Событие touchcancel срабатывает, когда одно или несколько касаний были прерваны специфичным для реализации способом.
Вот некоторые примеры ситуаций, которые приведут к срабатыванию события touchcancel:
- Возникает аппаратное событие, которое отменяет действия касания. Это может включать, например, переключение пользователем приложений с помощью интерфейса переключения приложений или кнопки «Домой» на мобильном устройстве.
- Ориентация экрана устройства изменяется во время активного касания.
- Браузер определяет, что пользователь случайно начал ввод касанием. Это может произойти, например, если оборудование поддерживает отказ от касания ладонью, чтобы предотвратить случайное срабатывание событий от руки, лежащей на дисплее при использовании стилуса.
- Свойство CSS
touch-actionпредотвращает продолжение ввода. - Когда пользователь взаимодействует слишком многими пальцами одновременно, браузер может сгенерировать это событие для всех существующих указателей (даже если пользователь по-прежнему касается экрана).
Синтаксис
Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.
addEventListener("touchcancel", (event) => {});
ontouchcancel = (event) => {};
Тип события
Объект TouchEvent. Наследуется от Event.
Свойства события
Этот интерфейс наследует свойства от родительского интерфейса 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