wxml：模板、引用

最新推荐文章于 2023-03-31 17:27:57 发布

原创最新推荐文章于 2023-03-31 17:27:57 发布 · 749 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#小程序

本文详细介绍了小程序中wxml的模板使用，包括如何定义模板、如何在不同位置调用模板及其作用域。同时，文章还探讨了引用机制，包括import和include的使用方式及其作用域概念。

模板

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

（1）定义模板

定义模板，使用name属性，作为模板的名字。即：

<template name="myTemplate">
<view>内容</view>
</template>

(2)使用模板

使用模板时，使用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>

（3）模板的作用域

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

引用

wxml提供两种文件引用方式：import和input。

（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 有作用域的概念，即只会 import 目标文件中定义的 template，而不会 import 目标文件 import 的 template。

如：C import B，B import A，在C中可以使用B定义的template，在B中可以使用A定义的template，但是C不能使用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"/>

（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>