触摸/手势api

更新时间:2024/05/06 访问次数:331

触摸API

API名称

参数

功能说明

my.onTouchStart(listener)

  • listener: Function(res: Object)
    • res:
      • touches: Array.<Touch>
      • changedTouches: Array.<Touch>
      • timeStamp: number


监听开始触摸事件

my.onTouchMove(listener)

  • listener: Function(res: Object)
    • res:
      • touches: Array.<Touch>
      • changedTouches: Array.<Touch>
      • timeStamp: number


监听触点移动事件

my.onTouchEnd(listener)

  • listener: Function(res: Object)
    • res:
      • touches: Array.<Touch>
      • changedTouches: Array.<Touch>
      • timeStamp: number


监听触摸结束事件

my.onTouchCancel(listener)

  • listener: Function(res: Object)
    • res:
      • touches: Array.<Touch>
      • changedTouches: Array.<Touch>
      • timeStamp: number


监听触点失效事件

my.offTouchStart(listener)

  • listener: Function(res: Object)
    • onTouchStart 传入的监听函数。不传此参数则移除所有监听函数。

移除开始触摸事件的监听函数

my.offTouchMove(listener)

  • listener: Function(res: Object)
    • onTouchMove 传入的监听函数。不传此参数则移除所有监听函数。

移除触点移动事件的监听函数

my.offTouchEnd(listener)

  • listener: Function(res: Object)
    • onTouchEnd 传入的监听函数。不传此参数则移除所有监听函数。

移除触摸结束事件的监听函数

my.offTouchCancel(listener)

  • listener: Function(res: Object)
    • onTouchCancel 传入的监听函数。不传此参数则移除所有监听函数。

移除触点失效事件的监听函数

Listener

字段

描述

touches

当前所有触摸点的列表

changedTouches

触发此次事件的触摸点列表

timeStamp

事件触发时的时间戳

Touch

字段

描述

number identifier

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

number pageX

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

number pageY

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

number clientX

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

number clientY

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

示例

const listener = function (res) { 
    console.log(res) 
}

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

FAQ

关于此文档暂时还没有FAQ
返回
顶部