文档中心 > 店铺动态卡片-开发指引

模板

更新时间:2023/02/03 访问次数:15686

axml 提供模板 template,可以在模板中定义代码片段,然后在不同地方调用。

建议使用 template 方式引入模版片段,因为 template 会指定其作用域,只使用 data 传入的数据,如果 templatedata 没有改变,该片段 UI 不会重新渲染。


一、定义模板


使用 name 属性申明模板名,然后在 <template/> 内定义代码片段。


<!--
  index: int
  msg: string
  time: string
-->
<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: '2019-04-19',
    },
  },
});


is 属性可以使用 Mustache 语法,来动态决定具体渲染哪个模板。


<template name="odd">
  <view> odd </view>
</template>
<template name="even">
  <view> even </view>
</template>
<block a:for="{{[1, 2, 3, 4, 5]}}">
    <template is="{{item % 2 == 0 ? 'even' : 'odd'}}"/>
</block>


三、模板作用域


模板有其作用域,只能使用 data 传入的数据。除了直接由 data 传入数据外,也可以通过 onXX 事件绑定页面逻辑进行函数处理。如下代码所示:


<!-- templ.axml -->
<template name="msgItem">
    <view>
        <view>
            <text> {{index}}: {{msg}} </text>
            <text> Time: {{time}} </text>
        </view>
        <button onTap="onClickButton">onTap</button>
    </view>
</template>


<!-- index.axml -->
<import src="./templ.axml"/>
<template is="msgItem" data="{{...item}}"/>


Page({
  data: {
    item: {
      index: 0,
      msg: 'this is a template',
      time: '2019-04-22'
    }
  },
  onClickButton(e) {
    console.log('button clicked', e)
  },
});


FAQ

关于此文档暂时还没有FAQ
返回
顶部