【微信小程序】视图与逻辑（页面导航、页面事件、生命周期、WXS脚本）

欢迎学习交流！！！
持续更新中…

---

1. 页面导航

页面导航指页面之间的相互跳转，浏览器中实现页面导航的方式有两种：<a>链接、location.href。而小程序中实现页面导航也有两种方式：

• 声明式导航：

    - 在页面上声明一个<navigator>导航组件
    - 通过点击<navigator>组件实现页面跳转
  

• 编程式导航：

    - 调用小程序的导航API，实现页面的跳转
  

声明式导航

导航到tabBar页面:

在使用 组件跳转到指定的 tabBar 页面时，需要指定 url 属性和 open-type 属性，其中：

• url 表示要跳转的页面的地址，必须以 /开头
• open-type 表示跳转的方式，必须为 switchTab

<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面</navogator>

导航到非tabBar页面:

在使用 组件跳转到普通的非 tabBar 页面时，需要指定 url 属性和 open-type 属性，其中：

• url 表示要跳转的页面的地址，必须以 / 开头
• open-type 表示跳转的方式，必须为 navigate
• open-type="navigate" 属性可以省略

后退导航:

如果要后退到上一页面或多级页面，则需要指定 open-type 属性和 delta 属性，其中：

• open-type 的值必须是 navigateBack，表示要进行后退导航
• delta 的值必须是数字，表示要后退的层级
• 如果只是后退到上一页，则可以省略delta属性，因为其默认值就是1

<navigator open-type="navigateBack" delta='1'>返回上一页</navogator>

编程式导航

导航到tabBar页面:

调用 wx.switchTab(Object object) 方法，即可跳转到tabBar页面。其中Object参数对象的属性如下：

属性	类型	是否必选	说明
url	string	是	需要跳转的tabBar页面的路径，路径后不能带参数
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

//页面结构
<button bindtap="gotoMessage">跳转到消息页面</button>

//通过编程式导航，跳转到message页面
gotoMessage() {
	wx.switchTab({
		url: '/pages/message/message'
	})
}

导航到非tabBar页面:

调用 wx.navigateTo(Object object) 方法，其中Object参数对象的属性列表如下：

属性	类型	是否必选	说明
url	string	是	需要跳转到的非tabBar页面的路径，路径后可以带参数
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

后退导航:

调用 wx.navigateBack(Object object) 方法，可以返回上一页面或多级页面。其中Object参数对象可选的属性列表如下：

属性	类型	默认值	是否必选	说明
delta	number	1	否	返回的页面数，如果delta大于现有页面数，则返回到首页
success	function	-	否	接口调用成功的回调函数
fail	function	-	否	接口调用失败的回调函数
complete	function	-	否	接口调用结束的回调函数（调用成功、失败都会执行）

导航传参

navigator组件和调用 wx.navigateTo(Object object) 方法时，url路径后可携带参数：

• 参数与路径之间使用?分隔
• 参数键与参数值用=相连
• 不同参数用&分隔

在onLoading中接收导航参数：
通过声明式导航传参或编程式导航传参所携带的参数，可以直接在onLoad事件中获取得到，例如：

/**
*	声明周期函数--监听页面加载
*/
onLoad: function(options) {
// options 就是导航传递过来的参数对象
	console.log(options)
}

2. 页面事件

下拉刷新

下拉刷新是移动端的专有名词，指通过手指在屏幕上的下拉滑动操作，从而重新加载页面数据。

开启下拉刷新：

• 全局开启：在app.json的 window 节点中，将 enablePullDownRefresh 设置为 true
• 局部开启：在页面的 .json 配置文件中，将 enablePullDownRefresh 设置为 true
• 在实际开发中，一般使用第二种，为需要的页面单独开启。

配置下拉刷新的窗口样式：

在全局或页面的 .json 配置文件中，通过 backgroundColor 和 backgroundTextStyle 来配置下拉刷新窗口的样式，其中：

• backgroundColor 用来配置下拉刷新窗口的背景颜色，仅支持16 进制的颜色值
• backgroundTextStyle 用来配置下拉刷新 loading 的样式，仅支持 dark 和 light

监听页面的下拉刷新事件：

在页面的 .js 文件中，通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。
当下拉刷新结束后，loading效果会一直在，不会主动消失，因此需要调用 wx.stopPullDownRefresh 函数来手动隐藏loading效果，停止当前页面的下拉刷新。

例，在页面的 wxml 中有如下的 UI 结构，点击按钮可以让 count 值自增 +1：

//页面结构
<view>count值为：{{count}}</view>
<button bindtap="countAdd">+1</button>

//+1按钮的点击事件处理函数
countAdd() {
	this.setData({
		count: this.data.count + 1
	})
}

在触发页面的下拉刷新事件时，若要把count的值重置为0，则：
/**
*	页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function() {
	this.setData({
		count: 0
	})
// 当数据重置成功后，调用此函数，关闭下拉刷新效果
wx.stopPullDowmRefresh()
}

上拉触底

上拉触底是移动端的专有名词，指通过手指在屏幕上的上拉滑动操作，从而加载更多数据。

• 通过 onReachBottom() 函数可监听当前页面的上拉触底事件。
• 上拉触底距离可以在全局或页面的.json配置文件中，通过 onReachBottomDistance 属性来配置。
• 小程序默认的触底距离是50px。

3. 生命周期

生命周期是指一个对象从创建 -> 运行 -> 销毁的整个阶段，强调的是一个时间段。

在小程序中，生命周期分成两类：

• 应用生命周期：指小程序从启动 -> 运行 -> 销毁的过程。
• 页面生命周期：指小程序每个页面的加载 -> 渲染 -> 销毁的过程。

其中，页面的生命周期范围较小，应用程序的生命周期范围较大。如图：

生命周期函数

生命周期函数：是由小程序框架提供的内置函数，会伴随着生命周期自动按次序执行

作用：生命周期函数允许开发者在特定的时间点执行某些特定的操作。如页面刚加载时，可以在onLoad生命周期函数中初始化页面的数据。

注：生命周期强调的是时间段，生命周期函数强调的是时间点。

应用的生命周期函数：

需要在app.js中声明，例如：

//app.js文件
App({
	//小程序初始化完成时，执行此函数，全局只触发一次，可以做一些初始化的工作
	onLaunch: function(options) { },
	//小程序启动，或从后台进入前台显示时触发
	onShow : function(options) { },
	//小程序从前台进入后台时触发
	onHide: function() { }
}) 

页面的生命周期函数：

需要在页面的.js文件中进行生命，例如：

//页面的 .js 文件
Page({
	onLoad : function(options) { },    //监听页面加载，一个页面只调用1次
	onShow : function() { },		   //监听页面显示
	onReady : function() { },		   //监听页面初次渲染完成，一个页面只调用1次
	onHide : function() { },		   //监听页面隐藏
	onUnload : function() { }		   //监听页面卸载，一个页面只调用1次
})

4. WXS脚本

WXS（WerXin Script）是小程序独有的一套脚本语言，结合WXML，可构建出页面的结构。

应用场景：wxml中无法调用在页面的 .js 中定义的函数，但wxml中可以调用wxs中定义的函数。小程序中wxs的经典应用场景就是“过滤器”。

wxs与JavaScript的关系：

1、wxs有自己的数据类型：number数值类型、string 字符串类型、boolean 布尔类型、object 对象类型、function 函数类型、array 数组类型、date 日期类型、regexp 正则
2、wxs 不支持类似于 ES6 及以上的语法形式

• 不支持：let、const、解构赋值、展开运算符、箭头函数、对象属性简写、etc…
• 支持：var 定义变量、普通 function 函数等类似于 ES5 的语法

3、wxs 遵循 CommonJS 规范：module 对象、require() 函数、module.exports 对象

WXS特点：

• 与JavaScript不同。WXS只是为了降低学习成本，设计时借鉴了大量的JS语法，但二者本质上并不相同
• 不能作为组件的事件回调

“过滤器”的经典应用：
<view>{{m2.toLower(country)}}</view>
不能作为组件的事件回调函数，错误用法：
<button bindtap="m2.toLower">按钮</button>

• 隔离性。wxs的运行环境和其他JS代码是隔离的：wxs不能调用js中定义的函数；wxs不能调用小程序提供的API。
• 性能好。在iOS设备中，小程序内的wxs会比JS代码块2~30倍

基础语法

内嵌wxs脚本：

wxs代码可以编写在wxml文件的<wxs>标签内。wxml文件中的每个<wxs></wxs>标签，必须提供module属性，用来指定当前wxs的模块名称，方便在wxml中访问模块中的成员：

<view>{{m1.toUpper(username)}}</view>

<wxs module="m1">
	//将文本转为大写形式  
	module.exports.toUpper = function(str) {
		return str.toUpperCase()
	}
</wxs>

定义外联的wxs脚本：

wxs代码还可以编写在以 .wxs 为后缀的文件内：

//tools.wxs文件
function toLower(str) {
	return str.toLowerCase()
}

module.exports = {
	toLower: toLower
}

使用外联的wxs脚本：

在wxml中引入外联的wxs脚本时，必须为<wxs>标签添加module和src属性：

• module用来指定模块的名称
• src用来指定要引入的脚本的路径，且必须是相对路径

<!-- 调用m2模块中的方法 -->
<view>{{m2.toLower(country)}}</view>

<!-- 引用外联的tools.wxs脚本，并命名为m2 --!>
<wxs src="../../utils/tools.wxs" module="m2"></wxs>