tencent cloud

腾讯云超级应用服务

触摸

Download
聚焦模式
字号
最后更新时间: 2025-04-10 18:18:36

onTouchStart

该 API 使用方法为 wx.onTouchStart(function listener)
功能说明:监听开始触摸事件。
参数及说明:function listener,开始触摸事件的监听函数,参数如下:
属性
类型
说明
touches
Array.<Touch>
当前所有触摸点的列表
changedTouches
Array.<Touch>
触发此次事件的触摸点的列表
timeStamp
number
事件触发时的时间戳

onTouchMove

该 API 使用方法为 wx.onTouchMove(function listener)
功能说明:监听触点移动事件。
参数及说明:function listener,触点移动事件的监听函数,参数如下:
属性
类型
说明
touches
Array.<Touch>
当前所有触摸点的列表
changedTouches
Array.<Touch>
触发此次事件的触摸点的列表
timeStamp
number
事件触发时的时间戳

onTouchEnd

该 API 使用方法为 wx.onTouchEnd(function listener)
功能说明:监听触摸结束事件。
参数及说明:function listener,触摸结束事件的监听函数,参数如下:
属性
类型
说明
touches
Array.<Touch>
当前所有触摸点的列表
changedTouches
Array.<Touch>
触发此次事件的触摸点的列表
timeStamp
number
事件触发时的时间戳

onTouchCancel

该 API 使用方法为 wx.onTouchCancel(function listener)
功能说明:监听触点失效事件。
参数及说明:function listener,触点失效事件的监听函数,参数如下:
属性
类型
说明
touches
Array.<Touch>
当前所有触摸点的列表
changedTouches
Array.<Touch>
触发此次事件的触摸点的列表
timeStamp
number
事件触发时的时间戳

offTouchStart

该 API 使用方法为 wx.offTouchStart(function listener)
功能说明:移除开始触摸事件的监听函数。
参数及说明:function listener,onTouchStart 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

wx.onTouchStart(listener)
wx.offTouchStart(listener) // 需传入与监听时同一个的函数对象

offTouchMove

该 API 使用方法为 wx.offTouchMove(function listener)
功能说明:移除触点移动事件的监听函数。
参数及说明:function listener,onTouchMove 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

wx.onTouchMove(listener)
wx.offTouchMove(listener) // 需传入与监听时同一个的函数对象

offTouchEnd

该 API 使用方法为 wx.offTouchEnd(function listener)
功能说明:移除触摸结束事件的监听函数。
参数及说明:function listener,onTouchEnd 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

wx.onTouchEnd(listener)
wx.offTouchEnd(listener) // 需传入与监听时同一个的函数对象

offTouchCancel

该 API 使用方法为 wx.offTouchCancel(function listener)
功能说明:移除触点失效事件的监听函数。
参数及说明:function listener,onTouchCancel 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

wx.onTouchCancel(listener)
wx.offTouchCancel(listener) // 需传入与监听时同一个的函数对象

Touch

在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作。

属性

number identifier

Touch 对象的唯一标识符,只读属性。一次触摸动作(我们值的是手指的触摸)在平面上移动的整个过程中, 该标识符不变。可以根据它来判断跟踪的是否是同一次触摸过程。

number pageX

触点相对于页面左边沿的 X 坐标。

number pageY

触点相对于页面上边沿的 Y 坐标。

number clientX

触点相对于可见视区左边沿的 X 坐标。

number clientY

触点相对于可见视区上边沿的 Y 坐标。

number force

手指挤压触摸平面的压力大小, 从0.0(没有压力)到1.0(最大压力)的浮点数(仅在支持 force touch 的设备返回)

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈