WXML
WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件、事件系统,可以构建出页面的结构。
数据绑定
WXML 中的动态数据均来自对应 Page 的 data。
简单绑定
数据绑定使用 Mustache 语法(双大括号)将变量包起来。
例如:
index.wxml
<!--wxml-->
<view>{{message}}</view>
index.js
// index.js
Page({
data: {
message: 'Hello world!'
}
})
组件属性(需要在双引号之内)
index.wxml
<!--wxml-->
<view id="item-{{id}}"></view>
index.js
// index.js
Page({
data: {
id: 0
}
})
控制属性(需要在双引号之内)
index.wxml
<view wx:if="{{condition}}"></view>
index.js
// index.js
Page({
data: {
condition: true
}
})
关键字(需要在双引号之内)
true
:boolean 类型的 true,代表真值。
false
: boolean 类型的 false,代表假值。
index.wxml
<!--wxml-->
<checkbox checked="{{false}}"></checkbox>
****特别注意:不要直接写 checked="false",其计算结果是一个字符串,转成 boolean 类型后代表真值。
运算
可以在{{}}
内进行简单的运算,支持的有如下几种方式:
三元运算
语法是“条件表达式?表达式1:表达式2”,
表达式为真则为1,为假则为2
index.wxml
<!--wxml-->
<view hidden="{{flag ? true : false}}">Hidden</view>
解析:flag为0则为flase视图view显示,flag为非0则为true视图view隐藏
算数运算
index.wxml
<!--wxml-->
<view>{{a + b}} + {{c}} + d</view>
index.js
// index.js
Page({
data: {
a: 1,
b: 2,
c: 3
}
})
解析:view中的内容为 3 + 3 + d。
逻辑判断
index.wxml
<!--wxml-->
<view wx:if="{{length > 5}}"></view>
解析:如果length大于5,则视图显示,小于5则隐藏
字符串运算
index.wxml
<!--wxml-->
<view>{{"hello" + name}}</view>
index.js
// index.js
Page({
data: {
name: 'world'
}
})
解析:view中的内容为helloworld
数据路径运算
index.wxml
<!--wxml-->
<view>{{object.key}} {{array[0]}}</view>
index.js
// index.js
Page({
data: {
object: {
key: 'hello '
},
array: ['world']
}
})
解析:view中的内容为hello world
组合
也可以在 Mustache 内直接进行组合,构成新的对象或者数组。
数组
index.wxml
<!--wxml-->
<view wx:for="{{[zero, 1, 2, 3, 4]}}">{{item}}</view>
index.js
// index.js
Page({
data: {
zero: 0
}
})
解析:最终组合成数组[0, 1, 2, 3, 4]
view中的内容为
0
1
2
3
4
对象(字典)
index.wxml
<!--wxml-->
<template is="objectCombine" data="{{for: a, bar: b}}"></template>
index.js
// index.js
Page({
data: {
a: 1,
b: 2
}
})
解析:最终组合成的对象是 {for: 1, bar: 2}
也可以用
扩展运算符
...
来将一个对象展开
index.wxml
<!--wxml-->
<template is="objectCombine" data="{{...obj1, ...obj2, e: 5}}"></template>
index.js
// index.js
Page({
data: {
obj1: {
a: 1,
b: 2
},
obj2: {
c: 3,
d: 4
}
}
})
解析:最终组合成的对象是 {a: 1, b: 2, c: 3, d: 4, e: 5}。
如果对象的 key 和 value 相同,也可以间接地表达。
index.wxml
<!--wxml-->
<template is="objectCombine" data="{{foo, bar}}"></template>
index.js
// index.js
Page({
data: {
foo: 'my-foo',
bar: 'my-bar'
}
})
解析:最终组合成的对象是{foo: ‘my-foo’, bar:‘my-bar’}。
注意:上述方式可以随意组合,但是如有存在变量名相同的情况,后边的会覆盖前面,如:
index.wxml
<!--wxml-->
<template is="objectCombine" data="{{...obj1, ...obj2, a, c: 6}}"></template>
index.js
// index.js
Page({
data: {
obj1: {
a: 1,
b: 2
},
obj2: {
b: 3,
c: 4
},
a: 5
}
})
错误模式{a: 1, b: 2,b: 3, c: 4,a: 5, c: 6}
解析:最终组合成的对象是 {a: 5, b: 3, c: 6}。
注意: 花括号和引号之间如果有空格,将最终被解析成为字符串
<view wx:for="{{[1,2,3]}} ">{{item}}</view>
等同于
<view wx:for="{{[1,2,3] + ' '}}">{{item}}</view>