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>