微信小程序入门五: wxml文件引用、模版、生命周期


实例内容

  • wxml文件引用(include、import)
  • 模版
  • 小程序生命周期

实例一: include方式引用header.wxml文件

文件引用对于代码的重用非常重要,例如在web开发中我们可以将公用的header部分和footer等部分进行提取,然后在需要的地方进行引用。

微信小程序里面,是包含引用功能的——includeimport。这两个引用文件的标签,使用基本差不多,这里先说一下include

微信中的视图文件引用,引用过来的都是没有渲染的,基本类似于直接将引用过来的文件复制到引用位置,所以我们需要重新对其渲染。

实例说明

这里将默认创建的用户头像信息提取出到header.wxml中,做为头部引用,分别由index2.wxmlindex3.wxml引用,引用方式为include

实例代码

pages中创建common/header.wxml

index.wxml中将系统默认创建的用户信息结构复制到header.wxml中。

header.wxml代码:

<!--pages/common/header.wxml-->
  <view  bindtap="bindViewTap" class="userinfo">
    <image class="userinfo-avatar" src="{{userInfo.avatarUrl}}" background-size="cover"></image>
    <text class="userinfo-nickname">{{userInfo.nickName}}</text>
  </view>

因为两个页面都要包含header.wxml,所以样式文件就不重复写了,这里直接将样式拷贝到app.wxss

app.wxss代码:

/**app.wxss**/
.userinfo {
  display: flex;
  flex-direction: column;
  align-items: center;
}

.userinfo-avatar {
  width: 128rpx;
  height: 128rpx;
  margin: 20rpx;
  border-radius: 50%;
}

.userinfo-nickname {
  color: #aaa;
}

创建index/index2index/index3

微信小程序入门五: wxml文件引用、模版、生命周期

index2.wxml内容:

<!--pages/index/index2.wxml-->
<view class="container">
    <include src="../common/header.wxml" />

    <view class="myBtn">
        <button type="primary" bindtap="goIndex3">进入index3</button>
    </view>    
</view>

因为index2.wxmlindex3.wxml都需要userInfo数据,所以这边在index2获取到数据后,使用本地存储进行存储,index3.wxml读取本地存储。

index2.js代码:

// pages/index/index2.js
var app = getApp()

Page({
  data: {
    userInfo: {},
  },

  goIndex3:function(){
    wx.navigateTo({
      url: ‘index3‘
    })
  },

  onLoad: function () {
    console.log(‘onLoad‘)
    var that = this
    app.getUserInfo(function (userInfo) {
      that.setData({
        userInfo: userInfo
      })

      //本地存储
      wx.setStorageSync(‘userInfo‘, userInfo)
    })
  }
})

index3.wxml代码:

<!--pages/index/index3.wxml-->

<view class="container">
    <include src="../common/header.wxml" />

    <text>pages/index/index3.wxml</text>
</view>

index3.js代码:

// pages/index/index3.js
Page({
  data:{
    userInfo: {},
  },
  onLoad:function(options){    
    this.setData({
      userInfo: wx.getStorageSync(‘userInfo‘)
    })
  },
})

实例效果

微信小程序入门五: wxml文件引用、模版、生命周期


实例二: import方式引用footer.wxml文件

这个实例使用import来引用文件,importinclude要强大的多,待会我再对于这两都进行一下对比。

import引用方式涉及到了微信的模版(template),这里先说一下template

微信视图模版(template)

template也是写在.wxml中,然后使用<template>...</template>标记指定模版信息,模版下定义:

<template name="msgItem">
    视图代码...
</template>

使用name属性,作为模板的名字。

使用模版:

<template is="msgItem" data="{{...item}}"/>

data为向模版传入的数据。

实例说明

使用模版的方式创建footer视图代码片,然后用importtemplate进行代码的调用。

实例代码

创建footer.wxml

微信小程序入门五: wxml文件引用、模版、生命周期

footer.wxml代码:

微信小程序入门五: wxml文件引用、模版、生命周期

index2.wxml代码:

微信小程序入门五: wxml文件引用、模版、生命周期

实例效果

微信小程序入门五: wxml文件引用、模版、生命周期


实例三: 小程序退出时清除本地数据

这里涉及到了小程序的生命周期问题,可以类比一下安卓生命周期,小程序的生命周期在app.js中进行定义:

属性 类型 描述 触发时机
onLaunch Function 生命周期函数–监听小程序初始化 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
onShow Function 生命周期函数–监听小程序显示 当小程序启动,或从后台进入前台显示,会触发 onShow
onHide Function 生命周期函数–监听小程序隐藏 当小程序从前台进入后台,会触发 onHide
onError Function 错误监听函数 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息

page生命周期:

属性 类型 描述
onLoad Function 生命周期函数–监听页面加载
onReady Function 生命周期函数–监听页面初次渲染完成
onShow Function 生命周期函数–监听页面显示
onHide Function 生命周期函数–监听页面隐藏
onUnload Function 生命周期函数–监听页面卸载

微信小程序入门五: wxml文件引用、模版、生命周期

这里用到了onUnload事件。

index2.js代码:

微信小程序入门五: wxml文件引用、模版、生命周期


includeimport

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

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

import的作用域

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

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


微信小程序入门系列

微信小程序入门一: 简 介、文本、事件、样式

微信小程序入门二: 条件、遍历、网络请求、获取本地图片

微信小程序入门三: 简易form、本地存储

微信小程序入门四: 导航栏样式、tabBar导航栏

微信小程序入门五: wxml文件引用、模版、生命周期


博客名称:王乐平博客

博客地址:http://blog.lepingde.com

CSDN博客地址:http://blog.csdn.net/lecepin


微信小程序入门五: wxml文件引用、模版、生命周期

微信小程序入门五: wxml文件引用、模版、生命周期

上一篇:微信 分享


下一篇:微信公众号 access_token 没有过期 却失效