通用事件

说明： 从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

事件说明

事件绑定在组件上，当组件达到事件触发条件时，会执行JS中对应的事件回调函数，实现页面UI视图和页面JS逻辑层的交互；
事件回调函数中通过参数可以携带额外的信息，如组件上的数据对象dataset，事件特有的回调参数。

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

名称	参数	描述	是否支持冒泡
touchstart	TouchEvent	手指刚触摸屏幕时触发该事件。 > 说明： TouchEvent具体可参考表2 TouchEvent对象属性列表	是⁵⁺
touchmove	TouchEvent	手指触摸屏幕后移动时触发该事件。	是⁵⁺
touchcancel	TouchEvent	手指触摸屏幕中动作被打断时触发该事件。	是⁵⁺
touchend	TouchEvent	手指触摸结束离开屏幕时触发该事件。	是⁵⁺
click	-	点击动作触发该事件。	是⁶⁺
doubleclick⁷⁺	-	双击动作触发该事件	否
longpress	-	长按动作触发该事件。	否
swipe⁵⁺	SwipeEvent	组件上快速滑动后触发该事件。 > 说明： SwipeEvent具体可参考表6 SwipeEvent 基础事件对象属性列表	否
attached⁶⁺	-	当前组件节点挂载在渲染树后触发。	否
detached⁶⁺	-	当前组件节点从渲染树中移除后触发。	否
pinchstart⁷⁺	PinchEvent	手指开始执行捏合操作时触发该事件。 > 说明： PinchEvent具体可参考表7 PinchEvent 对象属性列表	否
pinchupdate⁷⁺	PinchEvent	手指执行捏合操作过程中触发该事件。	否
pinchend⁷⁺	PinchEvent	手指捏合操作结束离开屏幕时触发该事件。	否
pinchcancel⁷⁺	PinchEvent	手指捏合操作被打断时触发该事件。	否
dragstart⁷⁺	DragEvent	用户开始拖拽时触发该事件。 > 说明： DragEvent具体可参考表8 DragEvent对象属性列表	否
drag⁷⁺	DragEvent	拖拽过程中触发该事件。	否
dragend⁷⁺	DragEvent	用户拖拽完成后触发。	否
dragenter⁷⁺	DragEvent	进入释放目标时触发该事件。	否
dragover⁷⁺	DragEvent	在释放目标内拖动时触发。	否
dragleave⁷⁺	DragEvent	离开释放目标区域时触发。	否
drop⁷⁺	DragEvent	在可释放目标区域内释放时触发。	否

说明： 除上述事件外，其他事件均为非冒泡事件，如input的change事件，详见各个组件。

表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	触摸接触面积。
force⁶⁺	number	接触力信息。

表6 SwipeEvent 基础事件对象属性列表（继承BaseEvent）

属性	类型	说明
direction	string	滑动方向，可能值有： 1. left：向左滑动； 2. right：向右滑动； 3. up：向上滑动； 4. down：向下滑动。
distance⁶⁺	number	在滑动方向上的滑动距离。

表7 PinchEvent 对象属性列表⁷⁺

属性	类型	说明
scale	number	缩放比例
pinchCenterX	number	捏合中心点X轴坐标，单位px
pinchCenterY	number	捏合中心点Y轴坐标，单位px

表8 DragEvent对象属性列表(继承BaseEvent)⁷⁺

属性	类型	说明
type	string	事件名称。
globalX	number	距离屏幕左上角坐标原点横向距离。
globalY	number	距离屏幕左上角坐标原点纵向距离。
timestamp	number	时间戳。

事件对象

当组件触发事件后，事件回调函数默认会收到一个事件对象，通过该事件对象可以获取相应的信息。

target对象：

属性	类型	说明
dataSet⁶⁺	Object	组件上通过通用属性设置的data-*的自定义属性组成的集合。

示例：

<!-- xxx.hml -->
<div>
  <div data-a="dataA" data-b="dataB" 
    style="width: 100%; height: 50%; background-color: saddlebrown;"@touchstart='touchstartfunc'></div>
</div>

// xxx.js
export default {
  touchstartfunc(msg) {
    console.info(`on touch start, point is: ${msg.touches[0].globalX}`);
    console.info(`on touch start, data is: ${msg.target.dataSet.a}`);
  }
}