抖音开放平台Logo
开发者文档
控制台

tt.onTouchCancel
收藏
我的收藏

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

监听触点失效事件。

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

语法

tt.onTouchCancel(callback)

参数说明

callback

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

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

属性名类型说明最低支持版本
touchesArray<object>

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

1.0.0
changedTouchesArray<object>

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);