抖音开放平台Logo
控制台

tt.onTouchCancel
收藏
我的收藏

基础库 1.0.0 开始支持本方法，这是一个同步方法。

监听触点失效事件。

前提条件无
业务背景无
使用限制无
注意事项无
相关教程无

语法

tt.onTouchCancel(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function是
监听事件的回调函数
1.0.0

callback 是一个回调函数，接收 object 类型的参数，属性如下：

属性名类型说明最低支持版本
touchesarray

Touch数组。当前所有触摸点的列表

1.0.0
changedTouchesarray

Touch数组。触发此次事件的触摸点列表

1.0.0
timeStampnumber
事件触发时的时间戳
1.0.0

touches 类型说明

object 类型，属性如下：

属性名类型说明最低支持版本
Touchobject
Touch 对象表示在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作
1.0.0

Touch 类型说明

object 类型，属性如下：

属性名类型说明最低支持版本
identifiernumber
Touch 对象的唯一标识符，只读属性。一次触摸动作(指手指的触摸)在平面上移动的整个过程中, 该标识符不变。 可以根据它来判断跟踪的是否是同一次触摸过程
1.0.0
screenXnumber
触点相对于屏幕左边沿的 X 坐标
1.0.0
screenYnumber
触点相对于屏幕上边沿的 Y 坐标
1.0.0

changedTouches 类型说明

object 类型，属性如下：

属性名类型说明最低支持版本
Touchobject
Touch 对象表示在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作
1.0.0

Touch 类型说明

object 类型，属性如下：

属性名类型说明最低支持版本
identifiernumber
Touch 对象的唯一标识符，只读属性。一次触摸动作(指手指的触摸)在平面上移动的整个过程中, 该标识符不变。 可以根据它来判断跟踪的是否是同一次触摸过程
1.0.0
screenXnumber
触点相对于屏幕左边沿的 X 坐标
1.0.0
screenYnumber
触点相对于屏幕上边沿的 Y 坐标
1.0.0

返回值

无

代码示例

function touchCallback({
  touches,
  changedTouches,
  timeStamp
}) {
  console.log('触点失效回调', touches, changedTouches, timeStamp)
};

tt.onTouchCancel(touchCallback);