抖音开放平台Logo
控制台

tt.offTouchEnd
收藏
我的收藏

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

取消监听触摸结束事件。

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

语法

tt.offTouchEnd(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.onTouchEnd(touchCallback);
tt.offTouchEnd(touchCallback);