模板与配置
1. WXML 模板语法
1.1 数据绑定
1.1.1 数据绑定的基本原则
- 在 data 中定义数据
在页面对应的.js 文件中,把数据定义到 data 对象中即可:
- 在 WXML 中使用数据
1.1.2 Mustache 语法的格式(双大括号)
例子:
pages/index/index.js
Page({
data: {
info: 'hello world'
}
})
pages/index/index.wxml
<!--index.wxml-->
<view>{{info}}</view>
1.1.3 Mustache 语法的应用场景
Mustache 语法的主要应用场景如下:
- 绑定内容
- 绑定属性
- 运算(三元运算,算术运算等)
动态绑定属性:
- wxml
// pages/shujubangding/shuxing.js
Page({
/**
* 页面的初始数据
*/
data: {
imgSrc: 'https://pic3.zhimg.com/80/v2-d2281f9328fa812c296e37e550ad9de2_1440w.webp'
},
...
})
- wxml
<image src="{{imgSrc}}" mode="aspectFit"></image>
三元运算:
<view>
{{randomNumber >= 5 ? '随机数字大于或者等于 5' : '随机数字小于 5'}}
</view>
data: {
randomNumber: Math.random() * 10
},
算数运算:
<view>
100 以内的随机数:{{randomNumber*100}}
</view>
data: {
randomNumber: Math.random().toFixed(2)
},
1.2 事件绑定
1.2.1 什么是事件
事件是渲染层到逻辑层的通讯方式,通过事件可以将用户在渲染层产生的行为,反馈到逻辑层进行业务的处理。
1.2.2 小程序中常用的事件
1.2.3 事件对象的属性列表
当事件回调触发的时候,会收到一个事件对象 event,他的详细属性如下表所示:
1.2.4 target 和 currentTarget 的区别
target 是触发该事件的源头组件,而 currentTarget 则是当前事件所绑定的 组件
点击内部的按钮时,点击事件以冒泡的方式向外扩散,也会触发外层 view 的 tap 事件处理函数。 此时,对于外层的 view 来说:
- e.target 指向的是触发事件的源头组件,因此,e.target 是内部的按钮组件
- e.currentTarget 指向的是当前正在触发事件的那个组件,因此,e.currentTarget 是当前的 view 组件
1.2.5 bindtap的语法格式
在小程序中,不存在 HTML 中的 onclick 鼠标点击事件,而是通过 tap 事件来响应用户的触摸行为。
-
通过 bindtap,可以为组件绑定 tap 触摸事件,语法如下:
-
wxml
<button type="primary" bind:tap="btnTapHandler">
按钮
</button>
js
btnTapHandler(e) {
console.log(e);
},
1.2.6 在事件处理函数中为 data 中的数据赋值
通过调用 this.setData(dataObject)
方法,可以给页面 data 中的数据重新赋值:
<button type="primary" bind:tap="countChange">
{{count}}
</button>
countChange(e) {
this.setData({
count: this.data.count + 1
})
},
/**
* 页面的初始数据
*/
data: {
count : 0
},
1.2.7 事件传参
小程序中的事件传参比较特殊,不能在绑定事件的同时为事件处理函数传递参数
可以为组件提供data-*
自定义属性传参,其中*
代表的是参数的名字:
<button bind:tap="btnHandler" data-info="{{2}}">事件传参</button>
- 最终
- info 会被解析位参数的名字
- 数值 2 会被解析为参数的值
在时间处理函数中,通过event.target.dataset.参数名
即可获得具体参数的值,示例代码如下:
<button type="primary"
bind:tap="btnTap2"
data-info="{{2}}"
>
{{count}}
</button>
btnTap2(e) {
console.log(e.target.dataset.info);
this.setData({
count: this.data.count + e.target.dataset.info
})
},
/**
* 页面的初始数据
*/
data: {
count : 0
},
1.2.8 bindinput 的语法格式
在小程序中,通过 input 事件来响应文本框的输入事件,语法格式如下:
<input bindinput="inputHandler"></input>
inputHandler(e) {
console.log(e.detail.value);
},
1.2.9 实现文本框和 data 之间的数据同步
实现步骤:
- 定义数据
- 渲染结构
- 美化样式
- 绑定 input 事件处理函数
<input value="{{msg}}" bindinput="inputHandler2"></input>
inputHandler2(e) {
this.setData(
{
msg: e.detail.value
}
)
},
/**
* 页面的初始数据
*/
data: {
count : 0,
msg: '请输入姓名:'
},
1.3 条件渲染
1.3.1 条件渲染
<view wx:if="{{condition}}">True</view>
<view wx:if="{{type===1}}">男</view>
<view wx:elif="{{type===2}}">女</view>
<view wx:else>保密</view>
1.3.2 结合<block>
使用wx:if
1.3.3 hidden
hidden="{{condition}}"
1.4 列表渲染
1.4.1 wx:for
data: {
arr1: ['苹果', '华为', '小米']
},
<view wx:for="{{arr1}}">
索引是{{index}}, 元素是{{item}}
</view>