微信小程序笔记七视图层——wxml

OStack程序员社区-中国程序员成长平台 › 门户 › 编程› 移动开发›小程序云开发高级教程

原作者: [db:作者] 来自: [db:来源] 收藏邀请

微信小程序的视图层由 *.wxml 组成，wxml与html一样属于标签语言，但wxml与html的标签截然不一样。

xwml特性

一、数据绑定

<!--wxml-->
<view> {{message}} </view>

// page.js
Page({
  data: {
    message: 'Hello MINA!'
  }
})

注意：标签属性中关键字需要在双引号内

    <!-- index/index.wxml-->
<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}}">Hidden</view>
<!-- 变量计算 -->
<view> {{a + b}} + {{c + b}} + {{a + c}} </view>
<!-- 字符串拼接 -->
<view>{{"hello" + name}}</view>
<!-- 数组遍历 -->
<view wx:for="{{ [id, class, 2, 3, 4] }}"> {{item}} </view>

二、列表渲染

<!--wxml-->
<view wx:for="{{array}}"> {{item}} </view>

// page.js
Page({
  data: {
    array: [1, 2, 3, 4, 5]
  }
})

类似 foreach 遍历集合

<!-- index/index.wxml-->
<view wx:for="{{array}}">
  {{index}} : {{item}}
</view>

// index/index.js
Page({
  data: {
    array: ["a","b","c"]
  }
})

item 获取元素，index 获取值

<!-- index/index.wxml-->
<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用法

如果列表中项目的位置会动态改变或者有新的项目添加到列表中，并且希望列表中的项目保持自己的特征和状态（如 <input/> 中的输入内容，<switch/> 的选中状态），需要使用 wx:key 来指定列表中项目的唯一的标识符。

wx:key 的值以两种形式提供

字符串，代表在 for 循环的 array 中 item 的某个 property，该 property 的值需要是列表中唯一的字符串或数字，且不能动态改变。
保留关键字 *this 代表在 for 循环中的 item 本身，这种表示需要 item 本身是一个唯一的字符串或者数字，如：（当数据改变触发渲染层重新渲染的时候，会校正带有 key 的组件，框架会确保他们被重新排序，而不是重新创建，以确保使组件保持自身的状态，并且提高列表渲染时的效率）

注：如不提供 wx:key，会报一个 warning，如果明确知道该列表是静态，或者不必关注其顺序，可以选择忽略。

<!--info/info.wxml-->
<!--选择器增加 wx:key 属性-->
<switch wx:for="{{switchArray}}" wx:key="id">{{item.val}}</switch>
<button bindtap="addSwitch">新增选择器</button>
<!--输入框未增加 wx:key 属性-->
<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 的输入框被输入框值后，再添加新的输入框时，被输入值的输入框无法被准确定位。

三、条件渲染

<!--wxml-->
<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 较好。

四、模板

<!--wxml-->
<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 属性用来指定模板的数据模型。

可以用模板快速搭建 隔行变色 商品列表等场景。

对象合并

<!-- index/index.wxml-->
<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
  }
})

用模板合并对象时注意，被合并对象变量名最好别重复，若重复则最后一个同名变量覆盖所有同名变量

<!-- index/index.wxml-->
<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(){}
})