tencent cloud

Tencent Cloud Super App as a Service

DocumentationTencent Cloud Super App as a ServiceMini Program Development GuideFrameworkWXML Syntax ReferenceReferencing

Referencing

PDF
Focus Mode
Font Size
Last updated: 2024-11-21 18:34:18
WXML provides two referencing methods import and include.

import

import can use the template defined by the target file in the current file, for example:
A template named item is defined in item.wxml:
<!-- item.wxml -->
<template name="item">
  <text>{{text}}</text>
</template>
By referencing item.wxml in index.wxml, you can use the item template:
<import src="item.wxml"/>
<template is="item" data="{{text: 'forbar'}}"/>

import Scope

The concept of “scope” is used for import references. This means that the reference will import the template defined in the target file, but will not import any import template in the target file.
For example: In the case C import B, B import A, the template defined by B can be used in C and the template defined by A can be used in B. However, C cannot use the template defined by A.
<!-- 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 can introduce the entire code excluding <template/> <wxs/>. This is equivalent to copying the code to the location of include. For example:
<!-- index.wxml -->
<include src="header.wxml"/>
<view> body </view>
<include src="footer.wxml"/>
<!-- header.wxml -->
<view> header </view>
<!-- footer.wxml -->
<view> footer </view>
Previous Topic: TemplatesNext Topic: Introduction

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback