微信小程序-事件

事件可以将用户的行为反馈到逻辑层进行处理。

事件可以绑定在组件上，当达到触发事件，就会执行逻辑层中对应的事件处理函数。

事件对象可以携带额外信息，如id, dataset, touches。

事件的使用方式

在组件中绑定一个事件处理函数。

如bindtap，当用户点击该组件的时候会在该页面对应的Page中找到相应的事件处理函数。

rush:html;toolbar:false"> Click me!

在相应的Page定义中写上相应的事件处理函数，参数是event。

rush:html;toolbar:false">Page({
tapName: function(event) {
console.log(event)
}
})

可以看到log出来的信息大致如下：

rush:html;toolbar:false">{
"type":"tap",
"timeStamp":895,
"target": {
"id": "tapTest",
"dataset":{
"hi":"WeChat"
}
},
"currentTarget":{
"id": "tapTest",
"dataset": {
"hi":"WeChat"
}
},
"detail": {
"x":53,
"y":14
},
"touches":[{
"identifier":0,
"pageX":53,
"pageY":14,
"clientX":53,
"clientY":14
}],
"changedtouches":[{
"identifier":0,
"pageX":53,
"pageY":14,
"clientX":53,
"clientY":14
}]
}

事件详解

事件分类

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

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

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

WXML的冒泡事件列表：

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased;">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; break-inside: avoid; background-color: rgb(246, 248, 249); border: none;" class="firstRow">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased;">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; break-inside: avoid; border: none;">

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">类型 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">触发条件 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">最低版本

事件绑定

事件绑定的写法同组件的属性，以 key、value 的形式。

key 以bind或catch开头，然后跟上事件的类型，如bindtap, catchtouchstart

value 是一个字符串，需要在对应的 Page 中定义同名的函数。不然当触发事件的时候会报错。

bind事件绑定不会阻止冒泡事件向上冒泡，catch事件绑定可以阻止冒泡事件向上冒泡。

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

outer view

middle view

inner view

事件对象

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

事件对象的属性列表：

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">ObjectBox-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">额外的信息Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; orphans: 3; widows: 3; margin-top: 0px; margin-bottom: 0.85em; line-height: 2; color: rgb(51, 51, 51); letter-spacing: 0.2px; text-indent: 0px; white-space: normal;">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; font-weight: 700;">TouchEvent 触摸事件对象属性列表（继承 BaseEvent）：

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">属性 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">类型 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">说明

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">ArrayBox-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 12px 20px; border-width: initial; border-style: none; border-color: initial;" height="60">触摸事件，当前变化的触摸点信息的数组Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; orphans: 3; widows: 3; margin-top: 0px; margin-bottom: 0.85em; line-height: 2; color: rgb(51, 51, 51); letter-spacing: 0.2px; text-indent: 0px; white-space: normal;">Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; font-weight: 700;">特殊事件：

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; break-inside: avoid; direction: ltr; margin: 0px; padding: 0.2em; border: none; color: inherit; background-color: rgb(247, 247, 247);">

中的触摸事件不可冒泡，所以没有 currentTarget。

代表事件的类型。

页面打开到触发事件所经过的毫秒数。

触发事件的源组件。

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">属性 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">类型 Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; padding: 6px 20px; border-width: initial; border-style: none; border-color: initial; font-weight: 400; color: rgb(141, 141, 141); text-align: left; height: 40px;">说明

事件绑定的当前组件。

Box-sizing: border-Box; -webkit-tap-highlight-color: transparent; text-size-adjust: none; -webkit-font-smoothing: antialiased; break-inside: avoid; direction: ltr; margin: 0px; padding: 0.2em; border: none; color: inherit; background-color: rgb(247, 247, 247);">data-

开头的自定义属性组成的集合说明： target 和 currentTarget 可以参考上例中，点击 inner view 时，handleTap3 收到的事件对象 target 和 currentTarget 都是 inner，而 handleTap2 收到的事件对象 target 就是 inner，currentTarget 就是 middle。

dataset

在组件中可以定义数据，这些数据将会通过事件传递给 SERVICE。书写方式：以data-开头，多个单词由连字符-链接，不能有大写(大写会自动转成小写)如data-element-type，最终在 event.target.dataset 中会将连字符转成驼峰elementType。

示例：

rush:html;toolbar:false"> DataSet Test

rush:html;toolbar:false">Page({
bindViewTap:function(event){
event.target.dataset.alphaBeta == 1 // - 会转为驼峰写法
event.target.dataset.alphabeta == 2 // 大写会转为小写
}
})