小程序开发第三节：视图与逻辑

附：「这是我参与2022首次更文挑战的第19天，活动详情查看：2022首次更文挑战

页面导航

1. 什么是页面导航

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

（1）链接

（2）location.href

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

（1）声明式导航

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

（2）编程式导航

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

2.1 声明式导航

（1）tabBar 页面

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

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

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

注意：使用组件时，必须添加 open-type，不然组件跳转效果会失效

（2）非 tabBar 页面

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

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

<navigator url="/pages/info/info" open-type="navigate">导航到info页面</navigator>

注意：为了简便，在导航到非 tabBar 页面时，open-type="navigate" 属性可以省略

（3）后退导航

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

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

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

注意：为了简便，如果只是后退到上一页面，则可以省略 dalta 属性，因为其默认值就是1

2.2 编程式导航

（1）tabBar 页面

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

示例代码如下：

#home.wxml

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

#home.js

gotoMessage(){
 wx.switchTab({
  url:"/pages/message/message"
 })
}

（2）导航到非 tabBar 页面

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

示例代码如下：

#home.wxml

<button bindtap="gotoInfo">跳转到 info 页面</button>

#home.js

gotoInfo(){
 wx.navigateTo({
  url:"/pages/info/info"
 })
}

（3）后退导航

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

示例代码如下：

#home.wxml

<button bindtap="gotoBack">后退</button>

#home.js

gotoBack(){
 wx.navigateBack() // wx.navigateBack()方法默认值为1，默认情况下后退1页
}

3. 导航传参

点击跳转到另外一个页面的时候，携带一些参数带过去

3.1 声明式导航传参

（1）传参

组件的 url 属性用来指定将要跳转到的页面的路径。同时，路径的后面还可以携带参数：

• 参数与路径之间使用 ？ 分隔
• 参数键与参数值用 = 相连

• 不同参数用 & 分隔

<navigator url="/page/info/info?name=xiaohe&age=19">跳转到info页面</navigator>

3.2 编程式导航传参

调用 wx.navigateTo(Object object)方法跳转页面时，也可以携带参数，代码示例如下：

#home.wxml

<button bindtap="gotoInfo2">跳转到info页面</button>

#home.js

gotoInfo2(){
 wx.navigateTo({
  url:"/pages/info/info?name=xiaohe&age=19"
 })
}

3.3 在 onLoad 中接收导航参数

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

#home.js

onLoad: function(options){
 console.log(options)
}

页面事件（待写）

1. 下拉刷新

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

1.1 启用下拉刷新

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

（1）全局开启下拉刷新：

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

（2）局部开启下拉刷新：

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

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

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

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

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

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

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

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

#home.wxml

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

#home.js

countAdd(){
 this.setData({
  count: this.data.count + 1
 })
}

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

#home.js

 onPullDownRefresh: function(){ // 当下拉刷新的时候就会触发这个函数
  this.setData({
   count: 0  
  })
 }

1.4 停止下拉刷新的效果

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

 onPullDownRefresh: function(){ // 当下拉刷新的时候就会触发这个函数
  this.setData({
   count: 0  
  })
  wx.stopPullDownRefresh()  // 当上面数据重置成功之后，会调用这个函数，关闭下拉刷新的效果
 }

2. 上拉触底

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

2.1 监听页面的上拉触底事件

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

#home.js

onReachBottom: function(){
 console.log("触发了上拉触底的事件")
}

2.2 配置上拉触底距离

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

3. 上拉触底实战 - 本地生活（待写）

生命周期

1. 生命周期

1.1 什么是生命周期

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

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

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

• 小程序的启动，表示生命周期的开始
• 小程序的关闭，表示生命周期的结束

1.2 生命周期的分类

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

（1）应用生命周期

• 特指小程序从启动 -> 运行 -> 销毁的过程

（2）页面生命周期

• 特指小程序中，每个页面的加载 -> 渲染 -> 销毁的过程

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

2 生命周期函数

2.1 什么是生命周期函数

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

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

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

2.2 生命周期函数的分类

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

（1）应用的生命周期函数

• 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数

（2）页面的生命周期函数

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

3. 应用的生命周期函数

• onLaunch: 页面数据初始化完成后触发
• onShow：后台进去前台显示时触发

• onHide：前台进入后台时触发（相当于退出当前小程序，小程序会保存进程，在后台运行）
• onError：当小程序发送错误会触发

// app.js
App({

  /**
   * 当小程序初始化完成时，会触发 onLaunch（全局只触发一次）
   */
  onLaunch: function () {
    console.log('页面数据初始化完成！');
  },

  /**
   * 当小程序启动，或从后台进入前台显示，会触发 onShow
   */
  onShow: function (options) {
      console.log('登录小程序了！');
  },

  /**
   * 当小程序从前台进入后台，会触发 onHide
   */
  onHide: function () {
    console.log('退出小程序了！');
  },

  /**
   * 当小程序发生脚本错误，或者 api 调用失败时，会触发 onError 并带上错误信息
   */
  onError: function (msg) {
    
  }
})

注意：以上几个生命周期，有两种方式可以来调试

1. 微信开发者工具里工具栏的切换后台/ 前台进行调试
2. 也可以扫码通过真机来模拟这几个生命周期函数

4. 页面的生命周期函数

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

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

开发中常用的生命周期：onLoad、onReady、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 是完全不同的两种语言：

（1）wxs 有自己的数据类型

• number：数值
• string：字符串
• boolean：布尔
• object：对象
• function：函数
• array：数组
• date：日期
• regexp：正则

（2）wxs 不支持类似于 ES6 及以上的语法形式

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

（3）wxs 遵循 CommonJS 规范

• module 对象
• require() 函数

• module.exports 对象

2. 基本语法

2.1 内嵌 wxs 脚本

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

#home.wxml

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

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

2.2 外联的 wxs 脚本（定义 + 使用）

（1）定义 wxs 脚本

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

#tools.wxs （某一个 .wxs 文件）

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

module.exports = {
 toLower: toLower
}

（2）使用 wxs 脚本

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

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

示例代码如下：

#home.wxml

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

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

3. wxs 的特点

3.1 与 JavaScript 不同

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

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

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

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

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

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

3.3 隔离性

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

（1）wxs 不能调用 js 中定义的函数

（2）wxs 不能调用小程序提供的API

3.4 性能好（android / iOS）

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

总结