• 页面导航
• 页面事件
• 生命周期
• WXS 脚本

一、页面导航

1.什么是页面导航

页面导航指的是页面之间的相互跳转。例如，浏览器中实现页面导航的方式有如下两种：

• <a> 链接
• location.href

2.小程序中实现页面导航的两种方式

• 声明式导航
  • 在页面上声明一个 <navigator> 导航组件
  • 通过点击 <navigator> 组件实现页面跳转
• 编程式导航
  • 调用小程序的导航 API，实现页面的跳转

3.声明式导航

3.1.导航到 tabBar 页面

tabBar 页面指的是被配置为 tabBar 的页面。 在使用 <navigator> 组件跳转到指定的 tabBar 页面时，需要指定 url 属性和 open-type 属性，其中：

• url 表示要跳转的页面的地址，必须以 / 开头

• open-type 表示跳转的方式，必须为 switchTab

示例代码如下：

<navigator url="/pages/message/message" open-type="switchTab">声明式跳转消息</navigator>

3.2.导航到非 tabBar 页面

非 tabBar 页面指的是没有被配置为 tabBar 的页面。 在使用 <navigator> 组件跳转到普通的非 tabBar 页面时，则需要指定 url 属性和 open-type 属性，其中：

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

示例代码如下：

# 注意：为了简便，在导航到非 tabBar 页面时，open-type="navigate" 属性可以省略。
<navigator url="/pages/info/info" open-type="navigate">声明式跳转info</navigator>

3.3.后退导航

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

• open-type 的值必须是 navigateBack，表示要进行后退导航
• delta 的值必须是数字，表示要后退的层级

示例代码如下：

# 注意：为了简便，如果只是后退到上一页面，则可以省略 delta 属性，因为其默认值就是 1。
<navigator open-type="navigateBack" delta="1">声明式返回上一页</navigator>

4.编程式导航

4.1.导航到 tabBar 页面

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

表格来源: 小程序官网switchTab

属性	类型	默认值	必填	说明
url	string		是	需要跳转的 tabBar 页面的路径 (代码包路径)（需在 app.json 的 tabBar 字段定义的页面），路径后不能带参数。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码如下：

// 页面标签
<button bindtap="skipMessage" type="primary" >编程式跳转消息</button>

 /**
  * 通过编程式跳转到message页面
  */
 skipMessage(){
   wx.switchTab({
     url: '/pages/message/message',
   })
 },

4.2.导航到非 tabBar 页面

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

表格来源: 小程序官网navigateTo

属性	类型	默认值	必填	说明
url	string		是	需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔；如 'path?key=value&key2=value2'
events	Object		否	页面间通信接口，用于监听被打开页面发送到当前页面的数据。基础库 2.7.3 开始支持。
routeType	string		是	2.29.2 自定义路由类型，相关文档 自定义路由
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码如下：

// 页面标签
<button bindtap="skipInfo" type="primary" plain>编程式跳转info</button>

  /**
   * 通过编程式跳转到Info页面
   */
  skipInfo(){
    wx.navigateTo({
      url: '/pages/info/info'
    })
  },

4.3.后退导航

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

表格来源: 小程序官网navigateBack

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

示例代码如下：

// 页面标签
<button bindtap="skipBack" type="primary" >编程式跳转info</button>
  /**
   * 编程式导航，返回上一层
   */
  skipBack(){
    wx.navigateBack({
      delta:1,
      success: (res) => {
        console.log("成功打印");
      }
    })
  },

5.导航传参

5.1.声明式、编程式导航传参一致

url 路径的后面可以携带参数：

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

示例代码如下：

/pages/info/info?name=张三&age=18

5.2.在 onLoad 中接收导航参数

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

  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    console.log(options);
  },

二、页面事件

1.下拉刷新事件

1.1.什么是下拉刷新

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

1.2. 启用下拉刷新

启用下拉刷新有两种方式：

• 全局开启下拉刷新

  • 在 app.json 的 window 节点中，将 enablePullDownRefresh 设置为 true

• 局部开启下拉刷新

  • 在页面的 .json 配置文件中，将 enablePullDownRefresh 设置为 true

在实际开发中，推荐使用第 2 种方式，为需要的页面单独开启下拉刷新的效果。

1.3.配置下拉刷新窗口的样式

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

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

1.4.监听页面的下拉刷新事件

在页面的 .js 文件中，通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。

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

# 页面标签
<view>
 count值是: {{ count }}
</view>
<button bindtap="addCount">+1</button>

/**
 * 点击 count + 1
 */
addCount(){
  this.setData({
    count: this.data.count + 1
  });
},

在触发页面的下拉刷新事件的时候，如果要把 count 的值重置为 0，示例代码如下：

/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
},

1.5.停止下拉刷新的效果

当处理完下拉刷新后，下拉刷新的 loading 效果会一直显示，不会主动消失，所以需要手动隐藏下拉刷新的loading 效果。此时，调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新。示例代码如下：

/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
  //当数据修改完成后,关闭下拉框
  wx.stopPullDownRefresh();
},

2.上拉触底事件

2.1.什么是上拉触底

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

2.2.监听页面的上拉触底事件

在页面的 .js 文件中，通过 onReachBottom() 函数即可监听当前页面的上拉触底事件。示例代码如下：

/**
 * 页面上拉触底事件的处理函数
 */
onReachBottom() {
  console.log("出发了上拉触底的事件");
},

2.3.配置上拉触底距离

上拉触底距离指的是触发上拉触底事件时，滚动条距离页面底部的距离。
可以在全局或页面的 .json 配置文件中，通过 onReachBottomDistance 属性来配置上拉触底的距离。
小程序默认的触底距离是 50px，在实际开发中，可以根据自己的需求修改这个默认值。

2.4.上拉触发案例

点击tabBar初始化随机10个颜色卡片展示,每当上拉触底新的随机10个颜色。效果如下:

案例的实现步骤:

1. 定义获取随机颜色的方法
2. 在页面加载时获取初始数据
3. 渲染 UI 结构并美化页面效果
4. 在上拉触底时调用获取随机颜色的方法
5. 添加 loading 提示效果
6. 对上拉触底进行节流处理

最终代码:

页面元素、样式(.wxml、.wxss):

<!-- rgb和rgba的区别关系
rgb和rgba都表示颜色。
rgb： 由红绿蓝三种颜色组成，由着三种颜色组合表示不同颜色，取值分别为0-255.
rgba： 在rbg的基础上加了alpha透明度，取值在0-1之间 -->
<view wx:for="{{ colorList}}" wx:key="index" style="background-color: rgba({{item}},0.3);" class="num-item">
  {{item}}
</view>

.num-item{
  border: 1rpx solid #efefef;
  border-radius: 8rpx;
  line-height: 200rpx;
  margin: 15rpx;
  text-align: center;
  text-shadow: 0rpx 0rpx 5rpx #fff;
  box-shadow:  0rpx 0rpx 5rpx #aaa;
}

.js方法:

  /**
   * 页面的初始数据
   */
  data: {
    //存放颜色
    colorList:[],
    //loding效果
    isLoding: false
  },
    /**
   * 获取颜色数据
   */
  getColors(){
    this.setData({
      isLoding: true
    });
    wx.showLoading({
      title: '数据加载中...',
    });
    wx.request({
      url: 'https://www.escook.cn/api/color',
      method:'GET',
      success: ({
          data: res
        }) => {
        console.log(res);
        this.setData({
          //es6语法 2个数组合并
          colorList: [...this.data.colorList,...res.data]
        });
      },
      complete: (res) =>{
        wx.hideLoading();
        this.setData({
          isLoding: false
        });
      }
    })
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    this.getColors();
  },
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    if(this.data.isLoding)return;
    this.getColors();
  },

三、生命周期

1.什么是生命周期

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

• 张三出生，表示这个人生命周期的开始
• 张三离世，表示这个人生命周期的结束
• 中间张三的一生，就是张三的生命周期

我们可以把每个小程序运行的过程，也概括为生命周期：

• 小程序的启动，表示生命周期的开始
• 小程序的关闭，表示生命周期的结束
• 中间小程序运行的过程，就是小程序的生命周期

2.生命周期的分类

在小程序中，生命周期分为两类，分别是：

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

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

3.什么是生命周期函数

生命周期函数：是由小程序框架提供的内置函数，会伴随着生命周期，自动按次序执行。 生命周期函数的作用：允许程序员在特定的时间点，执行某些特定的操作。例如，页面刚加载的时候，可以在onLoad 生命周期函数中初始化页面的数据。

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

4.生命周期函数的分类

小程序中的生命周期函数分为两类，分别是：

• 应用的生命周期函数
  • 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数
• 页面的生命周期函数
  • 特指小程序中，每个页面从加载 -> 渲染 -> 销毁期间依次调用的那些函数

5.应用的生命周期函数

小程序的应用生命周期函数需要在 app.js 中进行声明，示例代码如下：

// app.js
App({

  /**
   * 当小程序初始化完成时，会触发 onLaunch（全局只触发一次）
   */
  onLaunch: function () {},

  /**
   * 当小程序启动，或从后台进入前台显示，会触发 onShow
   */
  onShow: function (options) {},

  /**
   * 当小程序从前台进入后台，会触发 onHide
   */
  onHide: function () {},
})

6.页面的生命周期函数

小程序的页面生命周期函数需要在页面的 .js 文件中进行声明，示例代码如下：

// pages/message/message.js
Page({

  /**
   * 生命周期函数--监听页面加载
   * 一个页面只调用1次
   */
  onLoad(options) {},

  /**
   * 生命周期函数--监听页面初次渲染完成
   * 一个页面只调用1次
   */
  onReady() {},

  /**
   * 生命周期函数--监听页面显示
   */
  onShow() {},

  /**
   * 生命周期函数--监听页面隐藏
   */
  onHide() {},

  /**
   * 生命周期函数--监听页面卸载
   * 一个页面只调用1次
   */
  onUnload() {},
})

四、WXS 脚本

1.概述

1.1.什么是 wxs

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

1.2.wxs 的应用场景

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

1.3.wxs 和 JavaScript 的关系*

虽然 wxs 的语法类似于 JavaScript，但是 wxs 和 JavaScript 是完全不同的两种语言：

• wxs 有自己的数据类型
  • number 数值类型、string 字符串类型、boolean 布尔类型、*object *对象类型、
  • function 函数类型、array 数组类型、 date 日期类型、 regexp 正则
• wxs 不支持类似于 ES6 及以上的语法形式
  • 不支持：let、const、解构赋值、展开运算符、箭头函数、对象属性简写、etc...
  • 支持：var 定义变量、普通 function 函数等类似于 ES5 的语法
• wxs 遵循 CommonJS 规范
  • module 对象
  • *require()*函数module.exports 对象
  • module.exports 对象

2.基础语法

2.1.内嵌 wxs 脚本

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

<!-- 使用wxs脚本 -->
<view>
  {{m1.toUpper(userName)}}
</view>
<!-- 将文本内容转换为大写 -->
<wxs module="m1">
    module.exports.toUpper = function(str){
      return str.toUpperCase();
    }
</wxs>

2.2.定义外联的 wxs 脚本

wxs 代码还可以编写在以 .wxs 为后缀名的文件内，就像 javascript 代码可以编写在以 .js 为后缀名的文件中一样。示例代码如下：

一般创建到根目录中的utils文件夹中:

function toLower(str){
  return str.toLowerCase();
}

module.exports = {
  toLower : toLower
}

2.3.使用外联的 wxs 脚本

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

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

示例代码如下：

<view> {{m2.toLower(userName)}} </view>

<wxs module="m2" src="/utils/tools.wxs"></wxs>

3.WXS 的特点

3.1.与 JavaScript 不同

为了降低 wxs（WeiXin Script）的学习成本， wxs 语言在设计时借大量鉴了 JavaScript 的语法。但是本质上，wxs 和 JavaScript 是完全不同的两种语言！

3.2.不能作为组件的事件回调

wxs 典型的应用场景就是**"过滤器"，经常配合 Mustache 语法进行使用**，例如：

<view > {{m2.toLower(userName)}} </view>

但是，在 wxs 中定义的函数不能作为组件的事件回调函数。例如，下面的用法是错误的：

<button bindtap="m2.toLower">按钮</button>

3.3.隔离性

隔离性指的是 wxs 的运行环境和其他 JavaScript 代码是隔离的。体现在如下两方面：

• wxs 不能调用 js 中定义的函数
• wxs 不能调用小程序提供的 API

3.4.性能好

• 在 iOS 设备上，小程序内的 WXS 会比 JavaScript 代码快 2 ~ 20 倍
• 在 android 设备上，二者的运行效率无差异