微信小程序 教程之事件


Posted in Javascript onOctober 18, 2016

系列文章:

什么是事件

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

事件的使用方式

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

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

<view id="tapTest" data-hi="MINA" bindtap="tapName"> Click me! </view>

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

Page({
 tapName: function(event) {
 console.log(event)
 }
})

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

{
"type": "tap",
"timeStamp": 1252,
"target": {
 "id": "tapTest",
 "offsetLeft": 0,
 "offsetTop": 0,
 "dataset": {
 "hi": "MINA"
 }
},
"currentTarget": {
 "id": "tapTest",
 "offsetLeft": 0,
 "offsetTop": 0,
 "dataset": {
 "hi": "MINA"
 }
},
"touches": [{
 "pageX": 30,
 "pageY": 12,
 "clientX": 30,
 "clientY": 12,
 "screenX": 112,
 "screenY": 151
}],
"detail": {
 "x": 30,
 "y": 12
}
}

事件详解

事件分类

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

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

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

WXML的冒泡事件列表:

类型 触发条件
touchstart 手指触摸
touchmove 手指触摸后移动
touchcancel 手指触摸动作被打断,如来电提醒,弹窗
touchend 手指触摸动作结束
tap 手指触摸后离开
longtap 手指触摸后,超过350ms再离开

注:除上表之外的其他组件自定义事件都是非冒泡事件,如<form/>的submit事件,<input/>的input事件,<scroll-view/>的scroll事件,(详见各个组件)

事件绑定

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

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

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

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

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

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

事件对象

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

事件对象的属性列表:

属性 类型 说明
type String 事件类型
timeStamp Integer 事件生成时的时间戳
target Object 触发事件的组件的一些属性值集合
currentTarget Object 当前组件的一些属性值集合
touches Array 触摸事件,触摸点信息的数组
detail Object 额外的信息

通用事件类型

timeStamp

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

target

触发事件的源组件。

属性 说明
id 事件源组件的id
dataset 事件源组件上由data-开头的自定义属性组成的集合
offsetLeft, offsetTop 事件源组件的坐标系统中偏移量

currentTarget

事件绑定的当前组件。

属性 说明
id 当前组件的id
dataset 当前组件上由data-开头的自定义属性组成的集合
offsetLeft, offsetTop 当前组件的坐标系统中偏移量

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

dataset

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

示例:

<view data-alpha-beta="1" data-alphaBeta="2" bindtap="bindViewTap"> DataSet Test </view>

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

touches

touches是一个触摸点的数组,每个触摸点包括以下属性:

属性 说明
pageX,pageY 距离文档左上角的距离,文档的左上角为原点 ,横向为X轴,纵向为Y轴
clientX,clientY 距离页面可显示区域(屏幕除去导航条)左上角距离,横向为X轴,纵向为Y轴
screenX,screenY 距离屏幕左上角的距离,屏幕左上角为原点,横向为X轴,纵向为Y轴

特殊事件所携带的数据,如表单组件的提交事件会携带用户的输入,媒体的错误事件会携带错误信息,详见组件定义中各个事件的定义。

感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!

Javascript 相关文章推荐
用jquery来定位
Feb 20 Javascript
jquery多选项卡效果实例代码(附效果图)
Mar 23 Javascript
JS 获取滚动条高度示例代码
Oct 24 Javascript
jquery及原生js获取select下拉框选中的值示例
Oct 25 Javascript
jQuery中each()方法用法实例
Dec 27 Javascript
Bootstrap每天必学之导航条
Nov 27 Javascript
bootstrap 下拉多选框进行多选传值问题代码分析
Feb 14 Javascript
Vue实现virtual-dom的原理简析
Jul 10 Javascript
解决Vue使用mint-ui loadmore实现上拉加载与下拉刷新出现一个页面使用多个上拉加载后冲突问题
Nov 07 Javascript
mui框架 页面无法滚动的解决方法(推荐)
Jan 25 Javascript
详解javascript 变量提升(Hoisting)
Mar 12 Javascript
JQuery绑定事件四种实现方法解析
Dec 02 jQuery
微信小程序 教程之模板
Oct 18 #Javascript
微信小程序 教程之列表渲染
Oct 18 #Javascript
微信小程序 教程之条件渲染
Oct 18 #Javascript
微信小程序 教程之数据绑定
Oct 18 #Javascript
vue.js通过自定义指令实现数据拉取更新的实现方法
Oct 18 #Javascript
微信小程序 教程之WXML
Oct 18 #Javascript
原生JS实现匀速图片轮播动画
Oct 18 #Javascript
You might like
php集成套件服务器xampp安装使用教程(适合第一次玩PHP的新手)
2015/06/03 PHP
PHP基于ip2long实现IP转换整形
2020/12/11 PHP
非常好的js代码
2006/06/27 Javascript
jquery实现点击展开列表同时隐藏其他列表
2015/08/10 Javascript
JavaScript实现点击按钮字体放大、缩小
2016/02/29 Javascript
jQuery实现对无序列表的排序功能(附demo源码下载)
2016/06/25 Javascript
jQuery自适应轮播图插件Swiper用法示例
2016/08/24 Javascript
微信小程序入门教程
2016/11/18 Javascript
jQuery编写设置和获取颜色的插件
2017/01/09 Javascript
详解微信小程序开发之城市选择器 城市切换
2017/01/17 Javascript
jQuery使用unlock.js插件实现滑动解锁
2017/04/04 jQuery
Vue 页面切换效果之 BubbleTransition(推荐)
2018/04/08 Javascript
浅谈super-vuex使用体验
2018/06/25 Javascript
vue 移动端适配方案详解
2018/11/15 Javascript
layui 监听select选择 获取当前select的ID名称方法
2019/09/24 Javascript
[01:28]一分钟告诉你DOTA2 TI9不朽宝藏Ⅱ中有什么!
2019/07/09 DOTA
python 实现删除文件或文件夹实例详解
2016/12/04 Python
和孩子一起学习python之变量命名规则
2018/05/27 Python
python MNIST手写识别数据调用API的方法
2018/08/08 Python
pandas ix &amp;iloc &amp;loc的区别
2019/01/10 Python
Python3使用Matplotlib 绘制精美的数学函数图形
2019/04/11 Python
python实现关闭第三方窗口的方法
2019/06/28 Python
使用python telnetlib批量备份交换机配置的方法
2019/07/25 Python
python中for循环变量作用域及用法详解
2019/11/05 Python
python 字段拆分详解
2019/12/17 Python
2014年房地产销售工作总结
2014/12/01 职场文书
思想品德评语大全
2014/12/31 职场文书
2015财务年度工作总结范文
2015/05/04 职场文书
《清澈的湖水》教学反思
2016/02/17 职场文书
Python requests库参数提交的注意事项总结
2021/03/29 Python
如何用python绘制雷达图
2021/04/24 Python
pytorch 梯度NAN异常值的解决方案
2021/06/05 Python
Python虚拟环境virtualenv是如何使用的
2021/06/20 Python
基于HTML十秒做出淘宝页面
2021/10/24 HTML / CSS
利用Apache Common将java对象池化的问题
2022/06/16 Servers
html原生table实现合并单元格以及合并表头的示例代码
2023/05/07 HTML / CSS