【微信小程序】一文带你吃透小程序开发框架——视图层中的事件系统

0️⃣前言

• 事件是视图层到逻辑层的通讯方式。
• 事件可以将用户的行为反馈到逻辑层进行处理。
• 事件可以绑定在组件上，当达到触发事件，就会执行逻辑层中对应的事件处理函数。
• 事件对象可以携带额外信息，如 id, dataset, touches。

1️⃣事件的分类

事件分为冒泡事件和非冒泡事件：

1. 冒泡事件：当一个组件上的事件被触发后，该事件会向父节点传递。

2. 非冒泡事件：当一个组件上的事件被触发后，该事件不会向父节点传递。

3. WXML的冒泡事件列表：

类型	触发条件	最低版本
touchstart	手指触摸动作开始
touchmove	手指触摸后移动
touchcancel	手指触摸动作被打断，如来电提醒，弹窗
touchend	手指触摸动作结束
tap	手指触摸后马上离开
longpress	手指触摸后，超过350ms再离开，如果指定了事件回调函数并触发了这个事件，tap事件将不被触发	1.5.0
longtap	手指触摸后，超过350ms再离开（推荐使用longpress事件代替）
transitionend	会在 WXSS transition 或 wx.createAnimation 动画结束后触发
animationstart	会在一个 WXSS animation 动画开始时触发
animationiteration	会在一个 WXSS animation 一次迭代结束时触发
animationend	会在一个 WXSS animation 动画完成时触发
touchforcechange	在支持 3D Touch 的 iPhone 设备，重按时会触发	1.9.90

4. 注：除上表之外的其他组件自定义事件如无特殊声明都是非冒泡事件，如 form 的submit事件，input 的input事件，scroll-view 的scroll事件，(详见各个组件)

2️⃣事件的绑定方式

1) 普通事件绑定 - bind 绑定

1. 代码示例

   <view bindtap="tapName" class='start_container'>
   //也可以加冒号分隔
   	//<view bind:tap="tapName" class='start_container'>
   <text class='start'>开启小程序之旅</text>
   </view>
   Page({
         
         
     tapName: function(event) {
         
          console.log(event)}
   })
   

2. 如果用户点击这个 view ，则页面的 tapName 会被调用。

3. 此时，页面的 this.data.tapName 必须是一个字符串，指定事件处理函数名；如果它是个空字符串，则这个绑定会失效（可以利用这个特性来暂时禁用一些事件）

4. 自基础库版本 1.5.0 起，在大多数组件和自定义组件中， bind 后可以紧跟一个冒号，其含义不变，如 bind:tap 。基础库版本 2.8.1 起，在所有组件中开始提供这个支持。

2) 绑定并阻止事件冒泡 - catch 绑定:

1. 除 bind 外，也可以用 catch 来绑定事件。与 bind 不同， catch 会阻止事件向上冒泡。

   扫描二维码关注公众号，回复： 14561957 查看本文章

2. 代码示例:

   <view id="outer" bindtap="handleTap1">
     outer view
     <view id="middle" catchtap="handleTap2">
       middle view
       <view id="inner" bindtap="handleTap3">
         inner view
       </view>
     </view>
   </view>
   

3. 例如在上边这个例子中，点击 inner view 会先后调用handleTap3和handleTap2(因为tap事件会冒泡到 middle view，而 middle view 阻止了 tap 事件冒泡，不再向父节点传递)，点击 middle view 会触发handleTap2，点击 outer view 会触发handleTap1。

3) 互斥事件绑定

1. 自基础库版本 2.8.2 起，除 bind 和 catch 外，还可以使用 mut-bind 来绑定事件。一个 mut-bind 触发后，如果事件冒泡到其他节点上，其他节点上的 mut-bind 绑定函数不会被触发，但 bind 绑定函数和 catch 绑定函数依旧会被触发。

2. 换而言之，所有 mut-bind 是“互斥”的，只会有其中一个绑定函数被触发。同时，它完全不影响 bind 和 catch 的绑定效果

3. 例如在下边这个例子中，点击 inner view 会先后调用 handleTap3 和 handleTap2 ，点击 middle view 会调用 handleTap2 和 handleTap1

   <view id="outer" mut-bind:tap="handleTap1">
     outer view
     <view id="middle" bindtap="handleTap2">
       middle view
       <view id="inner" mut-bind:tap="handleTap3">
         inner view
       </view>
     </view>
   </view>
   

3️⃣事件的捕获阶段

1. 自基础库版本 1.5.0 起，触摸类事件支持捕获阶段。捕获阶段位于冒泡阶段之前，且在捕获阶段中，事件到达节点的顺序与冒泡阶段恰好相反。需要在捕获阶段监听事件时，可以采用capture-bind、capture-catch关键字，后者将中断捕获阶段和取消冒泡阶段。

2. 在下面的代码中，点击 inner view 会先后调用handleTap2、handleTap4、handleTap3、handleTap1

   <view id="outer" bind:touchstart="handleTap1" capture-bind:touchstart="handleTap2">
     outer view
     <view id="inner" bind:touchstart="handleTap3" capture-bind:touchstart="handleTap4">
       inner view
     </view>
   </view>
   

   如果将上面代码中的第一个capture-bind改为capture-catch，将只触发handleTap2。

   <view id="outer" bind:touchstart="handleTap1" capture-catch:touchstart="handleTap2">
     outer view
     <view id="inner" bind:touchstart="handleTap3" capture-bind:touchstart="handleTap4">
       inner view
     </view>
   </view>
   

4️⃣事件对象

如无特殊说明，当组件触发事件时，逻辑层绑定该事件的处理函数会收到一个事件对象。

1)BaseEvent 基础事件对象属性列表

1. 表格:

属性	类型	说明	基础库版本
type	String	代表事件的类型
timeStamp	Integer	事件生成时的时间戳–页面打开到触发事件所经过的毫秒数
target	Object	触发事件的组件的一些属性值集合–触发事件的源组件
currentTarget	Object	当前组件的一些属性值集合–事件绑定的当前组件
mark	Object	事件标记数据	2.7.1

2. 补充说明

3. target

   属性	类型	说明
   id	String	事件源组件的id
   dataset	Object	事件源组件上由data-开头的自定义属性组成的集合

4. currentTarget

   属性	类型	说明
   id	String	当前组件的id
   dataset	Object	当前组件上由data-开头的自定义属性组成的集合

   说明： target 和 currentTarget 可以参考上例中，点击 inner view 时，handleTap3 收到的事件对象 target 和 currentTarget 都是 inner，而 handleTap2 收到的事件对象 target 就是 inner，currentTarget 就是 middle

2) TouchEvent 触摸事件对象属性列表（继承 BaseEvent）：

1. 表格:

属性	类型	说明
touche	Array	触摸事件，当前停留在屏幕中的触摸点信息的数组
changedTouches	Array	触摸事件，当前变化的触摸点信息的数组

2. 补充说明

1. touches

   touches 是一个数组，每个元素为一个 Touch 对象（canvas 触摸事件中携带的 touches 是 CanvasTouch 数组）。 表示当前停留在屏幕上的触摸点。

   属性	类型	说明
   identifier	Number	触摸点的标识符
   pageX, pageY	Number	距离文档左上角的距离，文档的左上角为原点 ，横向为X轴，纵向为Y轴
   clientX, clientY	Number	距离页面可显示区域（屏幕除去导航条）左上角距离，横向为X轴，纵向为Y轴

2. changedTouches

   changedTouches 数据格式同 touches。 表示有变化的触摸点，如从无变有（touchstart），位置变化（touchmove），从有变无（touchend、touchcancel）

3) CustomEvent 自定义事件对象属性列表（继承 BaseEvent）：

1. 表格

属性	类型	说明
detail	Object	额外的信息 自定义事件所携带的数据，如表单组件的提交事件会携带用户的输入，媒体的错误事件会携带错误信息。

---