微信小程序模板深入使用

1. 什么是模板

WXML提供模板（template），可以在模板中定义代码片段，然后在不同的地方调用。

2. 模板的用处

把页面中具有相同结构的wxml wxss代码提炼到一处去，类似自定义标签一样，节省维护成本，提高编程效率，保证ui风格统一

3. 定义模板

使用 name 属性，作为模板的名字。然后在内定义代码片段，里面可以接收属性与定义事件，事件的触发函数需要写在被调用的页面中如：

<!--
  index: int
  msg: string
  time: string
-->
<template name="msgItem">
  <view bindtap="onTap">
    <text> {{index}}: {{msg}} </text>
    <text> Time: {{time}} </text>
  </view>
</template>
使用模板

4. 使用模板

使用 is 属性，声明需要的使用的模板，然后将模板所需要的 data 传入，如：

<template is="msgItem" data="{{...item}}"/>

// js中
Page({
  data: {
    item: {
      index: 0,
      msg: 'this is a template',
      time: '2019-07-30
    }
  },
  onTap() {  console.log('onTap') }
})

is 属性可以使用 Mustache 语法，来动态决定具体需要渲染哪个模板：

<template name="odd">
  <view> odd </view>
</template>
<template name="even">
  <view> even </view>
</template>

<block wx:for="{{[1, 2, 3, 4, 5]}}">
  <template is="{{item % 2 == 0 ? 'even' : 'odd'}}"/>
</block>

5. 模板的作用域

模板拥有自己的作用域，只能使用 data 传入的数据以及模板定义文件中定义的 模块。

// wxs文件
module.exports.message = "hello word"

// template文件
<wxs src="test.wxs" module="mes" />
<template name="msgItem"> 
 	<view>{{mes.message}}</view>
 </template>
 
 //wxml使用文件
 <import src="template/test.wxml" />
 <template is="msgItem" />
 
 // 页面显示 hello word

6. 模板写在另一个文件中的引用方式

WXML 提供两种文件引用方式import和include

6.1 import

import可以在该文件中使用目标文件定义的template，如：
在 item.wxml 中定义了一个叫item的template：

<!-- item.wxml -->
<template name="item">
  <text>{{text}}</text>
</template>

在 index.wxml 中引用了 item.wxml，就可以使用item模板：

<import src="item.wxml"/>
<template is="item" data="{{text: 'forbar'}}"/>

【注】
import 有作用域的概念，即只会 import 目标文件中定义的 template，而不会 import 目标文件 import 的 template。
如：C import B，B import A，在C中可以使用B定义的template，在B中可以使用A定义的template，但是C不能使用A定义的template。

6.2 include

include 可以将目标文件除了 外的整个代码引入，相当于是拷贝到 include 位置，如：

<!-- index.wxml -->
<include src="header.wxml"/>
<view> body </view>
<include src="footer.wxml"/>

<!-- header.wxml -->
<view> header </view>

<!-- footer.wxml -->
<view> footer </view>