作者:7777-丿M | 来源:互联网 | 2023-01-31 19:48
微信小程序的视图层由*.wxml组成,wxml与html一样属于标签语言,但wxml与html的标签截然不一样。xwml特性一、数据绑定<!--wxml--><
微信小程序的视图层由 *.wxml 组成,wxml与html一样属于标签语言,但wxml与html的标签截然不一样。
xwml特性
一、数据绑定
<view> {{message}} view>
// page.js
Page({
data: {
message: 'Hello MINA!'
}
})
注意:标签属性中关键字需要在双引号内
<text>选择text>
<checkbox checked="{{true}}">checkbox>
特别注意:
- 不要直接写
checked="false"
,其计算结果是一个字符串,转成 boolean 类型后代表真值。
- 花括号和引号之间如果有空格,将最终被解析成为字符串
<view wx:for="{{[1,2,3]}} ">
{{item}}
view>
<view wx:for="{{[1,2,3] + ' '}}">
{{item}}
view>
双大括号也可以参照 angularjs 中表达式用的,例如
<view hidden="{{flag ? true : false}}">Hiddenview>
<view> {{a + b}} + {{c + b}} + {{a + c}} view>
<view>{{"hello" + name}}view>
<view wx:for="{{ [id, class, 2, 3, 4] }}"> {{item}} view>
二、列表渲染
<view wx:for="{{array}}"> {{item}} view>
// page.js
Page({
data: {
array: [1, 2, 3, 4, 5]
}
})
类似 foreach 遍历集合
<view wx:for="{{array}}">
{{index}} : {{item}}
view>
// index/index.js
Page({
data: {
array: ["a","b","c"]
}
})
item 获取元素,index 获取值
<view wx:for="{{array}}" wx:for-index="key" wx:for-item="obj">
{{key}}: {{obj.val}}
view>
// index/index.js
Page({
data: {
array: [{val:"first"},{val:"second"},{val:"third"}]
}
})
可用 for-index 指定下标变量名,用 for-item 指定元素变量名
<view wx:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" wx:for-item="i">
<view wx:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" wx:for-item="j">
<view wx:if="{{i <= j}}">
{{i}} * {{j}} = {{i * j}}
view>
view>
view>
wx:for 和 for 循环一样可以嵌套使用,以上为九九乘法表
wx:key用法
如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 中的输入内容, 的选中状态),需要使用 wx:key 来指定列表中项目的唯一的标识符。
wx:key 的值以两种形式提供
- 字符串,代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
- 保留关键字 *this 代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字,如:(当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率)
注:如不提供 wx:key
,会报一个 warning
, 如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略。
<switch wx:for="{{switchArray}}" wx:key="id">{{item.val}}switch>
<button bindtap="addSwitch">新增选择器button>
<input wx:for="{{inputArray}}" placeholder="{{item.text}}"/>
<button bindtap="addInput">新增输入框button>
// info/info.js
Page({
data: {
switchArray: [{ id: 1, val: "item_1" },{ id: 0, val: "item_0" }],
inputArray:[{ id: 1, text: "输入框_1" },{ id: 0, text: "输入框_0" }]
},
// 添加选择器函数
addSwitch:function(){
const length = this.data.switchArray.length;
// 向array中添加一个元素,与array合并
this.data.switchArray = [{ id: length, val: 'item_' + length }].concat(this.data.switchArray);
// 重新加载 array
this.setData({
switchArray: this.data.switchArray
});
},
// 添加输入框
addInput:function(){
const length = this.data.inputArray.length;
// 向array中添加一个元素,与array合并
this.data.inputArray = [{id:length, text:'输入框_' + length}].concat(this.data.inputArray),
// 重新加载 array
this.setData({
inputArray: this.data.inputArray
});
}
})
该案例可看出,添加 wx:key 的选择器一旦被选中,不论添加多少,被选中的那个选择器状态始终没变;
而未添加 wx:key 的输入框被输入框值后,再添加新的输入框时,被输入值的输入框无法被准确定位。
三、条件渲染
<view wx:if="{{view == 'WEBVIEW'}}"> WEBVIEW view>
<view wx:elif="{{view == 'APP'}}"> APP view>
<view wx:else> MINA view>
// page.js
Page({
data: {
view: 'MINA'
}
})
类似 if else 的条件判断结构
wx:if 与 hidden 区别
因为 wx:if 之中的模板也可能包含数据绑定,所有当 wx:if 的条件值切换时,框架有一个局部渲染的过程,因为它会确保条件块在切换时销毁或重新渲染。
同时 wx:if 也是惰性的,如果在初始渲染条件为 false,框架什么也不做,在条件第一次变成真的时候才开始局部渲染。
相比之下,hidden 就简单的多,组件始终会被渲染,只是简单的控制显示与隐藏。
一般来说,wx:if 有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此,如果需要频繁切换的情景下,用 hidden 更好,如果在运行时条件不大可能改变则 wx:if 较好。
四、模板
<template name="staffName">
<view>
FirstName: {{firstName}}, LastName: {{lastName}}
view>
template>
<template is="staffName" data="{{...staffA}}">template>
<template is="staffName" data="{{...staffB}}">template>
<template is="staffName" data="{{...staffC}}">template>
// page.js
Page({
data: {
staffA: {firstName: 'Hulk', lastName: 'Hu'},
staffB: {firstName: 'Shang', lastName: 'You'},
staffC: {firstName: 'Gideon', lastName: 'Lin'}
}
})
模板为 页面中布局服用提供了非常好的解决方案,使得页面布局更加高效。
使用 template 标签定义模板,name属性用来定义模板名,在页面布局中用 is 属性指定需要的模板即可,data 属性用来指定模板的数据模型。
可以用模板快速搭建 隔行变色 商品列表 等场景。
对象合并
<template name="test">
<view>{{first}}view>
<view>{{second}}view>
template>
<template is="test" data="{{first: a, second: b}}">template>
<template is="test" data="{{first: (a + b), second: (a * b)}}">template>
// index/index.js
Page({
data: {
a:1,b:2
}
})
用模板合并对象时注意,被合并对象变量名最好别重复,若重复则最后一个同名变量覆盖所有同名变量
<template name="test">
<view wx:for="{{first}}">{{item}}view>
<view>===========================view>
<view wx:for="{{second}}">{{item}}view>
<view>===========================view>
<view wx:for="{{third}}">{{item}}view>
template>
<template is="test" data="{{ first:{...obj1},second:{...obj2},third:{...obj1,...obj2} }}">template>
// index/index.js
Page({
data: {
a:1,b:2,
obj1:{ name:"mirage",id:0 },
obj2: { nick: "fox", class: 1 }
}
})
// index/index.js
Page({
data: {
a:1,b:2,
obj1:{ name:"mirage",id:0 },
obj2: { name: "fox", id: 1 }
},
onLoad:function(){},
onShow:function(){}
})
模板的作用域
模板拥有自己的作用域,只能使用 data 传入的数据以及模版定义文件中定义的
模块。