引用

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

import

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

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

  1. <!-- item.wxml -->
  2. <template name="item">
  3.   <text>{{text}}</text>
  4. </template>

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

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

import 的作用域

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

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

  1. <!-- A.wxml -->
  2. <template name="A">
  3.   <text> A template </text>
  4. </template>
  1. <!-- B.wxml -->
  2. <import src="a.wxml"/>
  3. <template name="B">
  4.   <text> B template </text>
  5. </template>
  1. <!-- C.wxml -->
  2. <import src="b.wxml"/>
  3. <template is="A"/>  <!-- Error! Can not use tempalte when not import A. -->
  4. <template is="B"/>

include

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

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