小程序 – WXML – 事件绑定
简介
WXML(WeiXin Markup Language)是小程序框架设计的一套标签语言,用来构建小程序页面的结构,其作用类似于网页开发中的 HTML。
事件绑定
事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为,反馈到逻辑层进行业务的处理。
小程序中常用的事件
类型 | 绑定方式 | 事件描述 |
tap | bindtap 或 bind:tap | 手指触摸后马上离开,类似于 HTML 中的 click 事件 |
input | bindinput 或 bind:input | 文本框的输入事件 |
change | bindchange 或 bind:change | 状态改变时触发 |
事件对象的属性列表
当事件回调触发的时候,会收到一个事件对象 event,它的详细属性如下表所示
属性 | 类型 | 说明 |
type | String | 事件类型 |
timeStamp | Integer | 页面打开到触发事件所经过的毫秒数 |
target | Object | 触发事件的组件的一些属性值集合 |
currentTarget | Object | 当前组件的一些属性值集合 |
detail | Object | 额外的信息 |
touches | Array | 触摸事件,当前停留在屏幕中的触摸点信息的数组 |
changedTouches | Array | 触摸事件,当前变化的触摸点信息的数组 |
target 和 currentTarget 的区别
target 是触发该事件的源头组件,而 currentTarget 则是当前事件所绑定的组件。
点击内部的按钮时,点击事件以冒泡的方式向外扩散,也会触发外层 view 的 tap 事件处理函数。
此时,对于外层的 view 来说:
e.target 指向的是触发事件的源头组件,因此,e.target 是内部的按钮组件
e.currentTarget 指向的是当前正在触发事件的那个组件,因此,e.currentTarget 是当前的 view 组件
bindtap
在小程序中,不存在 HTML 中的 onclick 鼠标点击事件,而是通过 tap 事件来响应用户的触摸行为。
①通过 bindtap,可以为组件绑定 tap 触摸事件,语法如下:
②在页面的 .js 文件中定义对应的事件处理函数,事件参数通过形参 event(一般简写成 e) 来接收:
事件处理函数中为 data 中的数据赋值
通过调用 this.setData(dataObject) 方法,可以给页面 data 中的数据重新赋值,示例如下:
事件传参
小程序的传参使用 data-xxx 的方式进行赋值:
<button bindtap="changeCount" data-info="{{ 2 }}"></button>
<button bindtap="changeCount" data-foo="{{ xxx }}"></button>
// info 会被解析为参数的名字
// 数值 2 会被解析为参数的值
程序中的事件传参比较特殊,不能在绑定事件的同时为事件处理函数传递参数。
所以以下方式是不可取的:
<button bindtap="changeCount(2)"></button>
因为小程序会把 bindtap 的属性值,统一当作事件名称来处理,
相当于要调用一个名称为 "changeCount(2)" 的事件处理函数。
取得传参数据
在事件处理函数中,通过 event.target.dataset.参数名 即可获取到具体参数的值
若不使用 Mustache 语法,则 event.target.dataset
中的数据将为字符串类型
<button bindtap="changeCount" data-info="2"></button>
// event.target.dataset.info = "2"
bindinput
在小程序中,通过 input 事件来响应文本框的输入事件,语法格式如下:
通过 bindinput,可以为文本框绑定输入事件:
在页面的 .js 文件中定义事件处理函数:
实现文本框和 data 之间的数据同步
定义数据:
渲染结构:
美化样式:
绑定 input 事件处理函数:
文本框和button
不一样,文本框使用 event.detial.value
取得数据
共有 0 条评论