1. Page Navigation
1.1 Two Ways to Implement Page Navigation in Mini Programs
-
What is page navigation
Page navigation refers to the mutual jump between pages. For example, there are two ways to implement page navigation in a browser:
a
Labellocation.href
-
Two ways to implement page navigation in applet
-
Declarative Navigation
- Declare a
<navigator>
navigation - Realize page jump by clicking
<navigator>
component
- Declare a
-
Programmatic Navigation
- Call the navigation of the applet to
API
realize the page jump
- Call the navigation of the applet to
-
1.2 Navigate to the tabBar page
tabBar
page refers to tabBar
a
When using the <navigator>
component to jump to the specified tabBar
page, you need to specify the url
attribute and open-type
attribute, where:
url
Indicates that you want to jump页面的地址
, must/
start withopen-type
means跳转的方式
that it must beswitchTab
1.3 Navigating to non-tabBar pages
非 tabBar 页面
Refers tabBar
to
When using the <navigator>
component to jump to a normal non- tabBar
page, you need to specify the url
attribute and open-type
attribute, where:
url
Indicates that you want to jump页面的地址
, must/
start withopen-type
means跳转的方式
that it must benavigate
1.4 Back navigation
If you want to go back to the previous page or a multi-level page, you need to specify the open-type
attribute and delta
attribute, where
open-type
The value must benavigateBack
, indicating back navigationdelta
The value of must be a number indicating the level to go back
1.5 Navigate to the tabBar page
Call the wx.switchTab(Object object)
method to jump to the tabBar
page, where the list of properties of the Object
parameter object is as follows:
Attributes | Types of | Is it mandatory | illustrate |
---|---|---|---|
url | string | Yes | 需要跳转的 tabBar 页面的路径 ,路径后不能带参数。 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
1.6 导航到非 tabBar 页面
调用 wx.navigateTo(Object object)
方法,可以跳转到非 tabBar
的页面。其中 Object
参数对象的属性列表如下
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
1.7 后退导航
调用 wx.navigateBack(Object object)
方法,可以返回上一页面或多级页面。其中 Object
参数对象可选的属性列表如下:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
delta | number | 1 | 否 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页。 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
1.8 声明式导航传参
navigator
组件的url
属性用来指定将要跳转到的页面的路径。同时,路径的后面还可以携带参数
:
-
参数
与路径
之间使用?
分隔参数键
与参数值
用=
相连不同参数
用&
分隔
-
不能够往 tabBar 页面传递参数
-
代码示例如下:
1.9 编程式导航传参
-
调用
wx.navigateTo(Object object)
方法跳转页面时,也可以携带参数,代码示例如下:- 不能够往 tabBar 页面传递参数
-
示例代码:
1.10 在 onLoad 中接收导航参数
-
通过
声明式导航传参
或编程式导航传参
所写携带的参数,可以直接在onLoad
事件中直接获取到 -
示例代码:
2. 页面事件
2.1 了解什么是下拉刷新
下拉刷新
是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据
的行为
2.2 启动下拉刷新
在开启下拉刷新以后,如何不手动停止下拉,下拉动作会一直存在,不会弹回去
在模拟器中会弹回去,在真机上不会弹回去
-
启动下拉刷新的三种方式
-
全局开启下拉刷新
- 在
app.json
的window
节点中,将enablePullDownRefresh
设置为true
- 在
-
局部开启下拉刷新
- 在页面的
.json
配置文件中,将enablePullDownRefresh
设置为true
- 在页面的
-
使用小程序提供的 API 实现下拉刷新
wx.startPullDownRefresh()
-
-
在实际开发中,推荐使用第 2 种方式,
为需要的页面单独开启下拉刷新的效果
2.3 配置下拉刷新窗口的样式
在全局或页面的 .json
配置文件中,通过 backgroundColor
和 backgroundTextStyle
来配置下拉刷新窗口的样式,其中
backgroundColor
用来配置下拉刷新窗口的背景颜色
,仅支持 16 进制的颜色值backgroundTextStyle
用来配置下拉刷新loading
的样式,仅支持dark
和light
2.4 监听页面的下拉刷新事件
-
在页面的
.js
文件中,通过onPullDownRefresh()
函数即可监听当前页面的下拉刷新事件 -
案例1:在页面的
wxml
中有如下的UI
结构,点击按钮可以让count
值自增+1
-
案例2:在触发页面的下拉刷新事件的时候,如果要把
count
的值重置为 0,示例代码如下:
2.5 停止下拉刷新的效果
-
当处理完下拉刷新后,下拉刷新的
loading
效果会一直显示,不会主动消失
, 所以需要手动隐藏loading
效果,此时,调用wx.stopPullDownRefresh()
可以停止当前页面的上拉刷新 -
示例代码:
2.6 了解什么是上拉触底
上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为
2.7 监听页面的上拉触底事件
-
在页面的
.js
文件中,通过onReachBottom
函数即可监听当前页面上的上拉触底事件 -
示例代码如下
2.8 配置上拉触底距离
- 上拉触底距离指的是
触发上拉触底事件时,滚动条距离页面底部的距离
- 可以在全局或页面的
.json
配置文件中,通过onReachBottomDistance
属性来配置上拉触底的距离 - 小程序默认的触底距离是
50px
,在实际开发中,可以根据自己的需求修改这个默认值
3. 生命周期
3.1 什么是生命周期
-
生命周期
(Life Cycle)
是指一个对象从 创建 -> 运行 -> 销毁 的整个阶段,强调的是一个时间段 -
小程序的生命周期
- 小程序的
启动
,表示生命周期的开始
- 小程序的
关闭
,表示生命周期的结束
- 中间小程序运行的过程,就是小程序的生命周期
- 小程序的
3.2 小程序生命周期的两个分类
-
应用生命周期
- 特指小程序从启动 --> 运行 --> 销毁的过程
-
页面生命周期
- 特指小程序中,每个页面的加载 --> 渲染 --> 销毁的过程
-
注意:页面的生命周期范围较小,应用程序的生命周期范围较大
3.3 什么是生命周期函数
-
小程序框架提供的内置函数,会伴随着生命周期,自动按次序执行
-
生命周期函数的作用:
- 允许程序员在特定的生命周期时间点上,执行某些特定的操作
- 例如,页面刚加载的时候,在生命周期函数中自动发起数据请求,获取当前页面的数据
- 注意:生命周期强调的是时间段,生命周期函数强调的是时间点。
3.4 小程序中生命周期函数的两个分类
小程序中的生命周期函数分为两类,分别是:
-
应用生命周期函数
- 特指小程序从启动 --> 运行 --> 销毁期间依次调用的那些函数
-
页面生命周期函数
- 特指小程序中,每个页面从 加载 --> 渲染 --> 销毁期间依次调用的那些函数
3.5 应用的生命周期
-
app.js
是小程序执行的入口文件,在app.js
中必须调用App()
函数,且只能调用一次。其中,App()
函数是用来注册并执行小程序的 -
App(Object)
函数接收一个Object
参数,可以通过这个Object
参数,指定小程序的应用生命周期函数 -
app.js
中的代码App({ /** * 当小程序初始化完成时,会触发 onLaunch(全局只触发一次) */ onLaunch: function () { }, /** * 当小程序启动,或从后台进入前台显示,会触发 onShow */ onShow: function (options) { }, /** * 当小程序从前台进入后台,会触发 onHide */ onHide: function () { }, /** * 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息 */ onError: function (msg) { } }) 复制代码
3.6 页面的生命周期
-
每个小程序页面,必须拥有自己的
.js
文件,且必须调用Page()
函数,否则报错。其中Page()
函数用来注册小程序页面 -
Page(Object)
函数接收一个Object
参数,可以通过这个Object
参数,指定页面的生命周期函数 -
page.js
//index.js //获取应用实例 const app = getApp() Page({ /** * 页面的初始数据 */ data: { }, /** * 生命周期函数--监听页面加载 */ onLoad: function (options) { }, /** * 生命周期函数--监听页面初次渲染完成 */ onReady: function () { }, /** * 生命周期函数--监听页面显示 */ onShow: function () { }, /** * 生命周期函数--监听页面隐藏 */ onHide: function () { }, /** * 生命周期函数--监听页面卸载 */ onUnload: function () { }, /** * 页面相关事件处理函数--监听用户下拉动作 */ onPullDownRefresh: function () { }, /** * 页面上拉触底事件的处理函数 */ onReachBottom: function () { }, /** * 用户点击右上角分享 */ onShareAppMessage: function () { } }) 复制代码
4. wxs
4.1 什么是 wxs
-
什么是
wxs
WXS (WeiXin Script)
是小程序的一套脚本语言,结合WXML
,可以构建出页面的结构
-
wxs
的应用场景- 小程序中
wxs
的典型应用场景
就是过滤器
- 小程序中
4.2 wxs 和 JavaScript 的关系
-
虽然
wxs
的语法类似于JavaScript
,但是wxs
和JavaScript
是完全不同的两种语言-
wxs
有自己的数据类型number
数值类型string
字符串类型boolean
布尔类型object
对象类型function
函数类型array
数组类型date
日期类型regexp
正则
-
wxs
不支持类似于ES6
及以上的语法形式- ECMAScript
-
-
JavaScript: DOM、BOM、ECMAScript
-
wxs
遵循CommonJS
规范module
对象:module.export
require
函数
4.3 拓展: wxs
遵循 CommonJS
模块化规范
CommonJS
是javascript
的模块化规范之一,小程序的脚本语言wxs
遵循了CommonJS
规范,因此,使用wxs
时的体验和使用node.js
的体验比较相似。
-
module
对象- 每个
wxs
都是独立的模块,每个模块均有一个内置的 module 对象,每个模块都有自己独立的作用域。
- 每个
-
module.exports
- 由于
wxs
拥有独立作用域,所以在一个模块里面定义的变量与函数,默认为私有的,对其他模块不可见, - 通过
module.exports
属性,可以对外共享本模块的私有变量与函数。
- 由于
-
require函数
- 在
wxs
模块中引用其他wxs
文件模块,可以使用require
函数。
- 在
4.4 内嵌 wxs 脚本
-
使用的规则
-
wxs
代码可以编写在wxml
文件中的<wxs></wxs>
标签内,就像javascript
代码可以编写在html
文件中的<script></script>
标签内一样。 -
wxml
文件中的每个<wxs></wxs>
标签,必须提供一个module
属性,用来指定当前<wxs></wxs>
标签的模块名。在单个wxml
文件内,建议其值唯一。 -
module 属性值的命名必须符合下面两个规则:
- 首字符必须是:字母(a-z A-Z),下划线(_)
- 剩余字符可以是:字母(a-z A-Z),下划线(_), 数字(0-9)
-
-
案例代码
4.5 定义外联的 wxs 脚本
-
使用的规则
wxs
代码可以编写在以.wxs
为后缀名的文件内,就像javascript
代码可以编写在以.js
为后缀名文件中一样。
-
实例代码
4.6 使用外联的 wxs 脚本
-
在
wxml
中如果要引入外联的wxs
脚本,必须为<wxs></wxs>
标签添加module
和src
属性module
用来为<wxs></wxs>
标签指定模块名,作为当前页面访问这个模块的标识名称src
用来指定当前<wxs></wxs>
标签要引入的脚本路径,必须是相对路径
-
示例代码
4.7 了解 wxs 的 4 个特点
-
没有兼容性
wxs
不依赖于运行时的基础库版本,可以在所有版本的小程序中运行 -
与
javascript
不同- 为了降低
wxs
的学习成本,wxs
语言在设计时大量借鉴了JavaScript
语法 - 但本质上,
wxs
与javascript
是不同的语言,有自己的语法,并不和javascript
一致
- 为了降低
-
隔离性
-
wxs
的运行环境和其他javascript
代码是隔离的wxs
中不能调用其他javascript
文件中定义的函数- 也不能调用小程序提供的
API
-
-
不能作为事件回调
-
wxs
典型的应用场景就是过滤器
,经常配置Mustache
语法进行使用 -
wxs
函数不能作为组件的事件回调
-
-
性能好
iOS
设备上比javascript
运行快由于运行环境的差异,在
iOS
设备上小程序内的wxs
会比javascript
代码快 2 ~ 20 倍。在
android
设备上二者运行效率无差异
5.其它
5.1 介绍判断是否还有下一页数据的公式
-
如果下面的公式成立,则证明没有下一页数据了:
-
页码值 * 每页显示多少条数据 >= 总数据条数
page
*pageSize
>=total
- 举例1:假设总共有 77 条数据,如果每页显示 10 条数据,则总共分为 8 页,其中第 8 页只有 7 条数据 - page (7)* pageSize (10) >= total(77)不成立, 所以有下一页数据 - page (8)* pageSize (10) >= total(77)成立, 所以没有下一页数据 复制代码
- 举例2:假设总共有 80 条数据,如果每页显示 10 条数据,则总共分为 8 页,其中第 8 页面有 10条数据 - page (7)* pageSize (10) >= total(80)不成立, 所以有下一页数据 - page (8)* pageSize (10) >= total(80)成立, 所以没有下一页数据 复制代码
-
-
方式二:
- 可以将
total
的值, 和数组的长度进行对比
- 可以将
5.2 在手机上预览不了的问题
-
问题
- 小程序如果需要发起网络请求,必须在 服务器域名中对域名进行配置,
- 小程序会往配置域名中发起请求,
- 但是,我们并没有在后台配置服务器域名,所以在手机上访问不了
-
解决方案
- 手机扫码 --> 点击小程序右上角 三个点 --> 弹出面板,点击开发调试 --> 弹出新的面板,点击打开调试
- 点击悬浮框
vConsole
,会显示页面的结构,以及 log 等,在实际开发中,可以配置模拟器进行测试