 |
位置：电子教程 > 微信小程序入门教程 (如果看不到内容请使用360浏览器) | 推荐学习资源 |
|
位置：电子教程 > 微信小程序入门教程 (如果看不到内容请使用360浏览器) | 推荐学习资源 |
| 当前阅读教程：微信小程序入门教程 > 事件 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 阅读(22555525) 收藏 赞(5685) 分享 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 上一篇： 模板 | 下一篇： 引用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
事件是可以被控件识别的操作，如按下某个按钮，选择某个复选框。每一种控件有自己可以识别的事件，如小程序页面的加载、按钮的单击、表单的提交等事件，也包括编辑框（文本框）的文本改变事件，等等。 事件有如下特征： n 事件是视图层到逻辑层的通信方式。 n 事件可以将用户的行为反馈到逻辑层进行处理。 n 事件可以绑定在组件上，当达到触发事件，就会执行逻辑层中对应的事件处理函数。 n 事件对象可以携带额外信息，如 id、dataset、touches。 1.事件的使用方式在组件中绑定一个事件处理函数。如bindtap，当用户点击该组件的时候会在该页面对应的Page中找到相应的事件处理函数，.wxml文件代码示例如下： <view id="tapTest" data-hi="WeChat" bindtap="tapName"> Click me! </view> 在相应的Page定义中写上相应的事件处理函数，参数是event，.js文件代码示例如下： Page({ tapName: function(event) { console.log(event) } }) 可以看到log出来的信息大致如下： { "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 }] } 2.事件分类事件分为冒泡事件和非冒泡事件： n 冒泡事件：当一个组件上的事件被触发后，该事件会向父节点传递。 n 非冒泡事件：当一个组件上的事件被触发后，该事件不会向父节点传递。 WXML的冒泡事件列表参见表2-16。 表2-16 WXML的冒泡事件列表
注：除上表之外的其他组件自定义事件如无特殊声明都是非冒泡事件，如<form/>的submit事件，<input/>的input事件，<scroll-view/>的scroll事件。
3.事件绑定和冒泡事件绑定的写法同组件的属性，以 key、value 的形式： n key 以bind或catch开头，然后跟上事件的类型，如bindtap、catchtouchstart。自基础库版本 1.5.0 起，在非原生组件中，bind和catch后可以紧跟一个冒号，其含义不变，如bind:tap、catch:touchstart。 n value 是一个字符串，需要在对应的 Page 中定义同名的函数。不然当触发事件的时候会报错。 提示：bind事件绑定不会阻止冒泡事件向上冒泡，catch事件绑定可以阻止冒泡事件向上冒泡。
如在下面这个例子中，点击 inner view 会先后调用handleTap3和handleTap2(因为tap事件会冒泡到 middle view，而 middle view 阻止了 tap 事件冒泡，不再向父节点传递)，点击 middle view 会触发handleTap2，点击 outer view 会触发handleTap1，.wxml文件代码示例如下： <view id="outer" bindtap="handleTap1"> outer view <view id="middle" catchtap="handleTap2"> middle view <view id="inner" bindtap="handleTap3"> inner view </view> </view> </view> 4.事件的捕获阶段自基础库版本 1.5.0 起，触摸类事件支持捕获阶段。捕获阶段位于冒泡阶段之前，且在捕获阶段中，事件到达节点的顺序与冒泡阶段恰好相反。需要在捕获阶段监听事件时，可以采用capture-bind、capture-catch关键字，后者将中断捕获阶段和取消冒泡阶段。 在下面的代码中，点击 inner view 会先后调用handleTap2、handleTap4、handleTap3、handleTap1，.wxml文件代码示例如下： <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，.wxml文件代码示例如下： <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> 5.事件对象如无特殊说明，当组件触发事件时，逻辑层绑定该事件的处理函数会收到一个事件对象。 BaseEvent 基础事件对象属性如下：
CustomEvent 自定义事件对象属性（继承 BaseEvent）如下：
TouchEvent 触摸事件对象属性（继承 BaseEvent）如下：
特殊事件： <canvas/> 中的触摸事件不可冒泡，所以没有 currentTarget。 type代表事件的类型。 timeStamp页面打开到触发事件所经过的毫秒数。 target触发事件的源组件，属性如下：
currentTarget事件绑定的当前组件，属性如下：
说明： target 和 currentTarget 可以参考上例中，点击 inner view 时，handleTap3 收到的事件对象 target 和 currentTarget 都是 inner，而 handleTap2 收到的事件对象 target 就是 inner，currentTarget 就是 middle。 6.dataset在组件中可以定义数据，这些数据将会通过事件传递给 SERVICE。 书写方式： 以data-开头，多个单词由连字符-链接，不能有大写(大写会自动转成小写)如data-element-type，最终在 event.currentTarget.dataset 中会将连字符转成驼峰elementType。 .wxml文件代码示例如下： <view data-alpha-beta="1" data-alphaBeta="2" bindtap="bindViewTap"> DataSet Test </view> .js文件代码示例如下： Page({ bindViewTap:function(event){ event.currentTarget.dataset.alphaBeta === 1 // - 会转为驼峰写法 event.currentTarget.dataset.alphabeta === 2 // 大写会转为小写 } }) 7.touchestouches 是一个数组，每个元素为一个 Touch 对象（canvas 触摸事件中携带的 touches 是 CanvasTouch 数组）。 表示当前停留在屏幕上的触摸点。 Touch 对象属性如下：
8.changedToucheschangedTouches 数据格式同 touches。 表示有变化的触摸点，如从无变有（touchstart），位置变化（touchmove），从有变无（touchend、touchcancel）。 9.detail自定义事件所携带的数据，如表单组件的提交事件会携带用户的输入，媒体的错误事件会携带错误信息，详见组件定义中各个事件的定义。 点击事件的detail 带有的 x, y 同 pageX, pageY 代表距离文档左上角的距离。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 上一篇： 模板 | 下一篇： 引用 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
