微信小程序template模版的使用方法


Posted in Javascript onApril 13, 2019

前言

小程序开发语言虽然只能运行在微信小程序中, 但是它的设计同样遵循了主流前端框架的主要特征——组件化,在小程序中组件化的实现有两种方式: template 模版 和 Component 组件。 这两种方式分别适用于不同的场景。

  • template 模版 主要用于展示,模版中不涉及事件处理, 需要处理的事件逻辑放在调用模版的页面中。 一个 template 模版 只包含 wxml wxss 文件。
  • Component 组件 作为一个单独的功能模块,不仅可以包含页面展示还可以包含该模块的事件逻辑处理。 像一个页面一样, Component 组件 可以包含 wxml wxss js json 文件。

1. 创建 template 模版

不同于 page 和 Component 的创建, 在开发者工具中并不能快速创建一个 template 模版。所以需要单独创建 wxss wxml 文件。

微信小程序template模版的使用方法

template.wxml 文件语法

一个 template.wxml 文件中使用 <template> 标签包含一个模版, 一个 template.wxml 文件可以包含多个 <template>模版, 使用 name 属性作为模版的名称。

在模版中可以接受变量, 使用 {{}} 展示。 为变量的传递者由调用该模版的页面传递。

<template name="A">
 <text>template name: {{name}}</text>
</template>
<template name="B">
 <text>template name: {{name}} {{msg}}</text>
</template>

template.wxss 模版样式文件

模版可以拥有自己的样式文件

text{
 color: #cccccc;
}

2. 引用 template 模版

  • template 模版的引用需要使用 <import> 标签。 该标签的 src 属性为需要引用模版的路径。
  • template 模版的使用用 <template> 标签。 使用 is 属性来区别模版文件中定义的模版。
  • 使用 data 传入模版中的数据。

index.wxml

<import src="../tpls/template.wxml" />

<view>
 <template is="A" data="{{name}}"/>
 <template is="B" data="{{name, msg}}"/>
<view>

3. 引用模版样式

在 调用页面的 wxml 中引用了 template.wxml 后,模版的样式并不会引用, 需要在调用页面的 wxss 中单独引用 template.wxss 文件。

index.wxss

@import "./tpls/template.wxss"

4. 模版文件中的事件处理

在模版中定义的事件, 需要调用页面中执行。

template.wxml

<template name="A">
 <text bindtap="handleTap">template name: {{name}}</text>
</template>

index.js

Page({
 data: {},
 handleTap() {
 console.log('template 模版 click')
 }
})

5.  import 有作用域

import 有作用域的概念,即只会 import 目标文件中定义的 template,而不会 import 目标文件中 import 的 template,简言之就是 import 不具有递归的特性。

例如:C 引用 B,B 引用A,在C中可以使用B定义的 template,在B中可以使用A定义的 template ,但是C不能使用A定义的template

6. include 配合 template 模版

如同使用 <import src="xx/xx/xx.wxml"> <tempalte is="A" /> 引用和使用模版一样, 同样也可以使用 <include src="xx/xx/xx.wxml />" 来引用一个模版。

需要注意的是:

  • 使用 <include> 引用模版文件时, 并不能分别出模版文件的模版块, 所以使用 <include> 引用的模版文件中只能定义一个模版块。
  • include 可以将目标文件中除了 <template/> <wxs/> 外的整个代码引入,相当于是拷贝到 include 位置。
<!-- index.wxml -->
<include src="header.wxml"/>

<view> body </view>

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

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对三水点靠木的支持。

Javascript 相关文章推荐
利用js制作html table分页示例(js实现分页)
Apr 25 Javascript
JQuery查找DOM节点的方法
Jun 11 Javascript
javascript RegExp 使用说明
May 21 Javascript
jQuery中使用animate自定义动画的方法
May 29 Javascript
JavaScript之生成器_动力节点Java学院整理
Jun 30 Javascript
js实现随机点名系统(实例讲解)
Oct 18 Javascript
Javacript中自定义的map.js  的方法
Nov 26 Javascript
5 种JavaScript编码规范
Jan 30 Javascript
解决vue打包项目后刷新404的问题
Mar 06 Javascript
js实现每日签到功能
Nov 29 Javascript
Javascript类型判断相关例题及解析
Aug 26 Javascript
javascript实现随机抽奖功能
Dec 30 Javascript
vue基于viewer实现的图片查看器功能
Apr 12 #Javascript
js form表单input框限制20个字符,10个汉字代码实例
Apr 12 #Javascript
详解js创建对象的几种方法及继承
Apr 12 #Javascript
详解JQuery基础动画操作
Apr 12 #jQuery
React中阻止事件冒泡的问题详析
Apr 12 #Javascript
TypeScript中的方法重载详解
Apr 12 #Javascript
vue-cli 3.x配置跨域代理的实现方法
Apr 12 #Javascript
You might like
数据库中排序的对比及使用条件详解
2012/02/23 PHP
详解PHP对数组的定义以及数组的创建方法
2015/11/27 PHP
ajax+php实现无刷新验证手机号的实例
2017/12/22 PHP
php 可变函数使用小结
2018/06/12 PHP
javaScript parseInt字符转化为数字函数使用小结
2009/11/05 Javascript
jquery validator 插件增加日期比较方法
2010/02/21 Javascript
从零开始学习jQuery (二) 万能的选择器
2010/10/01 Javascript
jquery实现图片裁剪思路及实现
2013/08/16 Javascript
Jquery中的层次选择器与find()的区别示例介绍
2014/02/20 Javascript
JavaScript数组前面插入元素的方法
2015/04/06 Javascript
Jqgrid之强大的表格插件应用
2015/12/02 Javascript
javascript实现dom元素可拖动
2016/03/21 Javascript
JS功能代码集锦
2016/05/04 Javascript
使用webpack搭建react开发环境的方法
2018/05/15 Javascript
小程序登录态管理的方法示例
2018/11/13 Javascript
原生JavaScript实现弹幕组件的示例代码
2020/10/12 Javascript
vue缓存之keep-alive的理解和应用详解
2020/11/02 Javascript
python开发中module模块用法实例分析
2015/11/12 Python
django项目运行因中文而乱码报错的几种情况解决
2017/11/07 Python
Python WSGI的深入理解
2018/08/01 Python
解决python中画图时x,y轴名称出现中文乱码的问题
2019/01/29 Python
解决python web项目意外关闭,但占用端口的问题
2019/12/17 Python
python 装饰器功能与用法案例详解
2020/03/06 Python
python3代码中实现加法重载的实例
2020/12/03 Python
纯css3实现的动画按钮的实例教程
2014/11/17 HTML / CSS
CSS3属性box-shadow使用指南
2014/12/09 HTML / CSS
canvas进阶之贝塞尔公式推导与物体跟随复杂曲线的轨迹运动
2018/01/10 HTML / CSS
2014年应届大学生毕业自我鉴定
2014/01/31 职场文书
酒店秘书求职信范文
2014/02/17 职场文书
图书室标语
2014/06/21 职场文书
一份文言文检讨书
2014/09/13 职场文书
工资收入证明样本(5篇)
2014/09/16 职场文书
用Python提取PDF表格的方法
2021/04/11 Python
Java常用工具类汇总 附示例代码
2021/06/26 Java/Android
Apache Pulsar结合Hudi构建Lakehouse方案分析
2022/03/31 Servers
Python turtle编写简单的球类小游戏
2022/03/31 Python