引用

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

import

import 可以在该文件中使用目标文件定义的 template，如：

在 item.wxml 中定义了一个叫 item 的 template：

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

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

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

import 的作用域

import 有作用域的概念，即只会 import 目标文件中定义的 template，而不会 import 目标文件 import 的 template。

如：C import B，B import A，在C中可以使用B定义的template，但不能使用A定义的template。

<!-- a.wxml -->
<template name="A">
  <text> A template </text>
</template>

<!-- b.wxml -->
<import src="./a.wxml"/>
<template name="B">
  <text> B template </text>
</template>

<!-- c.wxml -->
<import src="./b.wxml"/>
<template is="A"/>  <!-- Error! Can not use tempalte when not import A. -->
<template is="B"/>

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>

与 import 共用：

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

<!-- header.wxml -->
<view> header </view>
<import src="./footer.wxml"/>
<template is="footer" />

<!-- footer.wxml -->
<template name="footer">
  <text> footer </text>
</template>