微信小程序学习之路《八》 模板引用

微信小程序开发 - 模板引用

 

 

模板

 

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

 

定义模板

使用name属性，作为模板的名字。然后在<template/>内定义代码片段，如：

<template name="msgItem"> <view> <text> {{index}}: {{msg}} </text> <text> Time: {{time}} </text> </view> </template>

 

使用模板

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

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

 

Page({ data: { item: { index: 0, msg: 'this is a template', time: '2016-09-15' } } })

 

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>

 

模板作用域

模板拥有自己的作用域，只能使用data传入的数据。

 

 

引用

 

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

 

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。

 

 

include

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

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