微信小程序 触控事件详细介绍


Posted in Javascript onOctober 17, 2016

微信小程序 触控事件:

            微信小程序的"事件"挺有意思。看了说明文档后发现它的功能很全,事件可以向父节点传递,而且打印这个事件的信息很透明,调试起来应该非常方便。
接下来把文档copy过来

原文地址:https://mp.weixin.qq.com/debug/wxadoc/dev/framework/view/wxml/event.html

》》》什么是事件

  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. touchstart 手指触摸
  2. touchmove 手指触摸后移动
  3. touchcancel 手指触摸动作被打断,如弹窗和来电提醒
  4. touchend 手指触摸动作结束
  5. tap 手指触摸后离开
  6. longtap 手指触摸后后,超过350ms离开

》》》事件绑定

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

  1. key 以bind或catch开头,然后跟上事件的类型,如bindtap, catchtouchstart
  2. value 是一个字符串,需要在对应的 Page 中定义同名的函数。不然当触发事件的时候会报错。 bind事件绑定不会阻止冒泡事件向上冒泡,catch事件绑定可以阻止冒泡事件向上冒泡。

上面简单介绍了小程序事件基础,是时候彰显"事件"的威力:

  1. 单击(tap)
  2. 双击(dbtap)
  3. 长按(longtap)
  4. 滑动
  5. 多点触控

1.单击

单击事件由touchstart、touchend组成,touchend后触发tap事件。

 微信小程序 触控事件详细介绍

<view>
 <button type="primary" bindtouchstart="mytouchstart" bindtouchend="mytouchend" bindtap="mytap">点我吧</button>
</view>
mytouchstart: function(e){ console.log(e.timeStamp + '- touch start')
},mytouchend: function(e){ console.log(e.timeStamp + '- touch end')
},mytap: function(e){ console.log(e.timeStamp + '- tap')
}

2.双击

双击事件由两个单击事件组成,两次间隔时间小于300ms认为是双击;微信官方文档没有双击事件,需要开发者自己定义处理。

 微信小程序 触控事件详细介绍

<view>
 <button type="primary" bindtap="mytap">点我吧</button>
</view>

 微信小程序 触控事件详细介绍

 3.长按

长按事件手指触摸后,超过350ms再离开。

 微信小程序 触控事件详细介绍

<view>
 <button type="primary" bindtouchstart="mytouchstart" bindlongtap="mylongtap" 
 bindtouchend="mytouchend" bindtap="mytap">点我吧</button>
</view>
mytouchstart: function(e){ console.log(e.timeStamp + '- touch start')
},//长按事件mylongtap: function(e){ console.log(e.timeStamp + '- long tap')
 },mytouchend: function(e){ console.log(e.timeStamp + '- touch end')
},mytap: function(e){ console.log(e.timeStamp + '- tap')
}

单击、双击、长按属于点触事件,会触发touchstart、touchend、tap事件,touchcancel事件只能在真机模拟,不多说了。

事件 触发顺序
单击 touchstart → touchend → tap
双击 touchstart → touchend → tap → touchstart → touchend → tap
长按 touchstart → longtap → touchend → tap

4.滑动

手指触摸屏幕并移动,为了简化起见,下面以水平滑动和垂直滑动为例。 滑动事件由touchstart、touchmove、touchend组成

 微信小程序 触控事件详细介绍

坐标图:

 微信小程序 触控事件详细介绍

  1. 以屏幕左上角为原点建立直角坐标系。第四象限为手机屏幕,Y轴越往下坐标值越大(注意跟数学象限的区别)。
  2. 假设A点为touchstart事件触摸点,坐标为A(ax,ay),然后手指向上滑动到点B(bx,by),就满足条件by < ay;
  3. 同理,向右滑动到C(cx,cy),满足cx > ax;向下滑动到D(dx,dy),满足dy > ay;向左移动到E(ex,ey)满足ex < ax.
  4. 计算线段AB在Y轴上投影长度为m,在X轴上的投影长度为n
  5. 计算r = m/n,如果r > 1,视为向上滑动。
  6. 同理计算线段AC,AD,AE在Y轴投影长度与X轴的投影长度之比,得出向右向下向左的滑动。

以上没考虑r为1的情况。

<view>
 <button type="primary" bindtouchstart="mytouchstart" bindtouchmove="mytouchmove">点我吧</button>
</view>

微信小程序 触控事件详细介绍

5.多点触控

由于模拟器尚不支持多点触控,内测开放后,继续补充。

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

Javascript 相关文章推荐
HTML Dom与Css控制方法
Oct 25 Javascript
jQuery实战之仿淘宝商城左侧导航效果
Apr 12 Javascript
jQuery简单实现隐藏以及显示特效
Feb 26 Javascript
jQuery实现一个简单的验证码功能
Jun 26 jQuery
AngularJS实现controller控制器间共享数据的方法示例
Oct 30 Javascript
关于vue编译版本引入的问题的解决
Sep 17 Javascript
vue router 源码概览案例分析
Oct 09 Javascript
JavaScript实现省市联动效果
Nov 22 Javascript
如何利用vue实现波谱拟合详解
Nov 05 Javascript
原生js实现自定义滚动条组件
Jan 20 Javascript
Handtrack.js库实现实时监测手部运动(推荐)
Feb 08 Javascript
JavaScript实现简单拖拽效果
Sep 15 Javascript
Angular2从搭建环境到开发步骤详解
Oct 17 #Javascript
使用ReactJS实现tab页切换、菜单栏切换、手风琴切换和进度条效果
Oct 17 #Javascript
学习Node.js模块机制
Oct 17 #Javascript
微信小程序 火车票查询实例讲解
Oct 17 #Javascript
让编辑器支持word复制黏贴、截屏的js代码
Oct 17 #Javascript
Node.js下自定义错误类型详解
Oct 17 #Javascript
js HTML5多媒体影音播放
Oct 17 #Javascript
You might like
谈谈新手如何学习PHP
2006/12/23 PHP
php对mongodb的扩展(初出茅庐)
2012/11/11 PHP
PHP漏洞全解(详细介绍)
2012/11/13 PHP
php实现在多维数组中查找特定value的方法
2015/07/29 PHP
PHP实现网站应用微信登录功能详解
2019/04/11 PHP
js 函数的副作用分析
2011/08/23 Javascript
jQuery实现“扫码阅读”功能
2015/01/21 Javascript
javascript单页面手势滑屏切换原理详解
2016/03/21 Javascript
浅析BootStrap栅格系统
2016/06/07 Javascript
jquery与ajax获取特殊字符实例详解
2017/01/08 Javascript
javascript基础练习之翻转字符串与回文
2017/02/20 Javascript
jquery操作select取值赋值与设置选中实例
2017/02/28 Javascript
Vue2 Vue-cli中使用Typescript的配置详解
2017/07/24 Javascript
vue上传图片组件编写代码
2017/07/26 Javascript
前端把html表格生成为excel表格的实例
2017/09/19 Javascript
angularJS的radio实现单项二选一的使用方法
2018/02/28 Javascript
浅谈webpack-dev-server的配置和使用
2018/05/17 Javascript
小程序云开发部署攻略(图文教程)
2018/10/30 Javascript
node.js命令行教程图文详解
2019/05/27 Javascript
vue利用全局导航守卫作登录后跳转到未登录前指定页面的实例代码
2020/05/19 Javascript
[02:08]什么藏在DOTA2 TI9“小紫本”里?斧王历险记告诉你!
2019/05/17 DOTA
Win7上搭建Cocos2d-x 3.1.1开发环境
2014/07/03 Python
Python函数装饰器实现方法详解
2018/12/22 Python
Python数据类型之List列表实例详解
2019/05/08 Python
Python面向对象程序设计之类和对象、实例变量、类变量用法分析
2020/03/23 Python
Html5 页面适配iPhoneX(就是那么简单)
2019/09/05 HTML / CSS
全球性的在线时尚男装零售商:boohooMAN
2016/12/17 全球购物
德国最大的网上足球商店:11teamsports
2019/09/11 全球购物
八一建军节演讲稿
2014/09/10 职场文书
街道务虚会发言材料
2014/10/20 职场文书
2014高三学生考试作弊检讨书
2014/12/14 职场文书
毕业生就业推荐表自我评价
2015/03/02 职场文书
详解Laravel制作API接口
2021/05/31 PHP
Python制作动态字符画的源码
2021/08/04 Python
Python中异常处理用法
2021/11/27 Python
使用 DataAnt 监控 Apache APISIX的原理解析
2022/07/07 Servers