通用事件

相对于私有事件,大部分组件都可以绑定如下事件。

名称

参数

描述

touchstart

TouchEvent

手指刚触摸屏幕时触发该事件。

touchmove

TouchEvent

手指触摸屏幕后移动时触发该事件。

touchcancel

TouchEvent

手指触摸屏幕中动作被打断时触发该事件。

touchend

TouchEvent

手指触摸结束离开屏幕时触发该事件。

click

-

点击动作触发该事件。

longpress

-

长按动作触发该事件。

swipe5+

SwipeEvent

组件上快速滑动后触发。

表 1 BaseEvent对象属性列表

属性

类型

说明

type

string

当前事件的类型,比如click、longpress等。

timestamp

number

该事件触发时的时间戳。

表 2 TouchEvent对象属性列表(继承BaseEvent)

属性

类型

说明

touches

Array<TouchInfo>

触摸事件时的属性集合,包含屏幕触摸点的信息数组。

changedTouches

Array<TouchInfo>

触摸事件时的属性集合,包括产生变化的屏幕触摸点的信息数组。数据数据格式和touches一样。该属性表示有变化的触摸点,如从无变有,位置变化,从有变无。例如用户手指刚接触屏幕时,touches数组中有数据,但changedTouches无数据。

表 3 TouchInfo

属性

类型

说明

globalX

number

距离屏幕左上角(不包括状态栏)横向距离。屏幕的左上角为原点。

globalY

number

距离屏幕左上角(不包括状态栏)纵向距离。屏幕的左上角为原点。

localX

number

距离被触摸组件左上角横向距离。组件的左上角为原点。

localY

number

距离被触摸组件左上角纵向距离。组件的左上角为原点。

size

number

触摸接触面积。

表 4 SwipeEvent 基础事件对象属性列表(继承BaseEvent)

属性

类型

说明

direction

string

滑动方向,可能值有:

  1. left:向左滑动;
  2. right:向右滑动;
  3. up:向上滑动;
  4. down:向下滑动。