小程序事件处理&Mpx框架事件处理

Doraemon193
203 阅读4分钟

微信小程序原生事件处理

(1). 事件分类

1.冒泡事件（事件向父节点传递）
类型触发条件
tap点击
longpress长按350ms以上
touchstart、touchmove、touchend、touchcancel滑动屏幕的开始、移动中、结束，以及动作打断（来电、弹窗等）
touchforcechange3D Touch 重按时触发
transitionend会在 WXSS transition 或 wx.createAnimation 动画结束后触发
animationstart会在一个 WXSS animation 动画开始时触发
animationiteration会在一个 WXSS animation 一次迭代结束时触发
animationend会在一个 WXSS animation 动画完成时触发
2.非冒泡事件（事件不向父节点传递）

除上表之外的其他组件自定义事件如无特殊声明都是非冒泡事件，如 [form]的submit事件，[input]的input事件，[scroll-view]的scroll事件

(2).事件绑定

1.以属性方式绑定

bind 后可以紧跟一个冒号，如 bind:tap

<view bindtap="handleTap">
    Click here!
</view>
2.以数据方式绑定

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

<view bindtap="{{ handlerName }}">
    Click here!
</view>
3.阻止事件冒泡

  • 用catch绑定事件并阻止事件冒泡

    • 点击inner会触发handleTap3和handleTap2
    • 点击middle会触发handleTap2
    • 点击outer会触发handleTap1
<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.互斥事件绑定

  • 用mut-bind绑定事件，只会触发一个mut-bind绑定的事件，bind和catch不影响

    • 点击inner，触发3和2
    • 点击middel，触发2和1
    • 点击outer，触发1
<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>
5.捕获阶段触发事件
  • 用capture-bind或capture-catch绑定事件，capture-catch在触发当前事件后，停止后续所有事件的触发（中断捕获阶段和取消冒泡阶段）
<!--点击 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>
​
<!--点击 inner view 仅调用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>
6.事件对象
  • BaseEvent基础事件对象属性
属性类型说明
typeString事件类型
timeStampInteger页面打开到触发事件所经过的毫秒数
targetObject触发事件的源组件的id和data-开头的自定义属性
currentTargetObject当前组件的id和data-开头的自定义属性
markObject事件标记数据
  • CustomEvent自定义事件对象属性
属性类型说明
detailObject额外的信息
  • TouchEvent 触摸事件对象属性
属性类型说明
touchesArray触摸事件，当前停留在屏幕中的触摸点信息的数组
changedTouchesArray触摸事件，当前变化的触摸点信息的数组
属性详解：

1.target和currentTarget的区别：

  • target是触发事件的元素；
  • currentTarget是事件绑定的元素（点击内层元素冒泡触发的事件，事件绑定的元素就不是触发事件的元素）；

2.dataset:

  • 原生小程序事件绑定时不能传参，要通过dataset语法传参；
  • data-开头的属性存在事件对象currentTarget中的dataset中；
  • data-后面的名字才是该属性的名字，大写会转小写，横杠转驼峰；
<view data-alpha-beta="1" data-alphaBeta="2" bindtap="bindViewTap"> DataSet Test </view>

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

3.mark:

  • mark可以用于识别target节点；

  • mark类似于dataset；区别是：

    • dataset只能包含当前一个节点的data-属性；
    • mark可以包含从触发事件的节点到根节点的所有mark属性；
    • 如果存在同名的 mark ，父节点的 mark 会被子节点覆盖；
    • 在自定义组件中接收事件时， mark 不包含自定义组件外的节点的 mark；
    • 非冒泡事件的mark属性也会被记录；
    • 节点的 mark 不会做连字符和大小写转换；
<view mark:myMark="last" bindtap="bindViewTap">
  <button mark:anotherMark="leaf" bindtap="bindButtonTap">按钮</button>
</view>

Page({
  bindViewTap: function(e) {
    e.mark.myMark === "last" // true
    e.mark.anotherMark === "leaf" // true
  }
})

4.touches:

  • touches是一个数组，每个元素是一个Touch对象；
  • canvas触摸事件携带的touches是CanvasTouch数组，每个元素是一个CanvasTouch对象；

(1).Touch对象：

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

(2).CanvasTouch 对象：

属性类型说明
identifierNumber触摸点的标识符
x, yNumber距离 Canvas 左上角的距离，Canvas 的左上角为原点 ，横向为X轴，纵向为Y轴

5.changedTouches

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

6.detail:

  • 自定义事件所携带的数据，如表单组件的提交事件会携带用户的输入，媒体的错误事件会携带错误信息，详见组件定义中各个事件的定义。
  • 点击事件的detail 带有的 x, y 同 pageX, pageY 代表距离文档左上角的距离。

(3).mpx事件处理

mpx不需要通过dataset传参，可以跟vue一样在事件后面加括号传参

<template>
  <view>
    <!--原生小程序语法，通过dataset进行传参-->
    <button data-name="a" bindtap="handleTap">a</button>
    <!--Mpx增强语法，模板内联传参，方便简洁-->
    <button bindtap="handleTapInline('b')">b</button>
    <!--参数支持传递字面量和组件数据-->
    <button bindtap="handleTapInline(name)"></button>
    <!--参数同样支持传递for作用域下的item/index-->
    <button wx:for="{{names}}" bindtap="handleTapInline(item)">{{item}}</button>
    <!--需要使用原始事件对象时可以传递$event特殊关键字-->
    <button bindtap="handleTapInlineWithEvent('g', $event)">g</button>
  </view>
</template>
​
<script>
  import { createComponent } from '@mpxjs/core'
​
  createComponent({
    data: {
      name: 'c',
      names: ['d', 'e', 'f']
    },
    methods: {
      handleTap (e) {
        console.log('name:', e.target.dataset.name)
      },
      // 直接通过参数获取数据，直观方便
      handleTapInline (name) {
        console.log('name:', name)
      },
      handleTapInlineWithEvent (name, e) {
        console.log('name:', name)
        console.log('event:', e)
      }
    }
  })
</script>
avatar
文章
阅读
粉丝