目录
这篇文章的主题是视图与逻辑,分为以下几个部分学习: 页面导航,页面事件,生命周期,WXS脚本,案例(本地生活列表页面)
如果您没阅读前一篇文章,建议您返回阅读:微信小程序开发入门到实战【从0到1~入门篇2】
小程序框架的目标是通过尽可能简单、高效的方式让开发者可以在微信中开发具有原生 APP 体验的服务。
小程序框架提供了自己的视图层描述语言 WXML 和 WXSS ,以及 JavaScript ,并在视图层与逻辑层间提供了数据传输和事件系统,让开发者能够专注于数据与逻辑。
您将学习以下内容:
① 能够知道如何实现页面之间的导航跳转
⚫ 声明式导航、编程式导航
② 能够知道如何实现下拉刷新效果
⚫ enablePullDownRefresh、onPullDownRefresh
③ 能够知道如何实现上拉加载更多效果
⚫ onReachBottomDistance、onReachBottom
④ 能够知道小程序中常用的生命周期函数
⚫ 应用生命周期函数:onLaunch, onShow, onHide
⚫ 页面生命周期函数:onLoad, onShow, onReady, onHide, onUnload
1、页面导航
页面导航指的是页面之间的相互跳转。例如,浏览器中实现页面导航的方式有如下两种:
① 链接
② location.href
小程序中实现页面导航的两种方式
① 声明式导航
- 在页面上声明一个 导航组件
- 通过点击 组件实现页面跳转
② 编程式导航 - 调用小程序的导航 API,实现页面的跳转
1.1 声明式导航
1.1.2 导航到 tabBar 页面
tabBar 页面指的是被配置为 tabBar 的页面。
在使用 组件跳转到指定的 tabBar 页面时,需要指定 url 属性和 open-type 属性,其中:
- url 表示要跳转的页面的地址,必须以 / 开头
- open-type 表示跳转的方式,必须为 switchTab
示例代码如下:
<text>pages/home/home.wxml</text>
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面</navigator>
message页面为tabBar页面
点击之后则跳转到了消息页面:
页面目录结构,info为普通页面
1.1.3 导航到非 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” 属性可以省略。
点击后跳转到了info页面
1.1.4 后退导航
如果要后退到上一页面或多级页面,则需要指定 open-type 属性和 delta 属性,其中:
- open-type 的值必须是 navigateBack,表示要进行后退导航
- delta 的值必须是数字,表示要后退的层级
示例代码如下:
<navigator open-type='navigateBack' delta='1'>返回上一页</navigator>
注意:为了简便,如果只是后退到上一页面,则可以省略 delta 属性,因为其默认值就是 1。
1.2编程式导航
//home.wxml
<button bindtap="gotoMessage">跳转到message页面</button>
//home.js
// 通过编程式导航跳转到 tabBar 页面
gotoMessage() {
wx.switchTab({
url: '/pages/message/message'
})
},
点击前:
点击后:
<button bindtap="gotoInfo">跳转到info页面</button>
gotoInfo() {
wx.navigateTo({
url: '/pages/info/info'
})
},
1.3导航传参
微信小程序中,页面导航传参是指在不同页面之间跳转时传递数据的过程。
1.3.1声明式导航传参
navigator 组件的 url 属性用来指定将要跳转到的页面的路径。同时,路径的后面还可以携带参数:
⚫ 参数与路径之间使用 ? 分隔
⚫ 参数键与参数值用 = 相连
⚫ 不同参数用 & 分隔
代码示例如下:
<navigator url="/pages/info/info?name=zs&age=20">跳转到info页面</navigator>
1.3.2编程式导航传参
调用 wx.navigateTo(Object object) 方法跳转页面时,也可以携带参数,代码示例如下:
<button bindtap="gotoInfo2">跳转到info页面</button>
gotoInfo2() {
wx.navigateTo({
url: '/pages/info/info?name=ls&gender=男'
})
},
1.3.3在 onLoad 中接收导航参数
通过声明式导航传参或编程式导航传参所携带的参数,可以直接在 onLoad 事件中直接获取到,示例代码如下:
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
console.log(options)
},
刚开始Console没有内容输出
点击跳转页面后Console输出所传递的参数
2、页面事件
在微信小程序开发中,页面事件指的是与页面生命周期相关的一系列事件处理函数,它们在页面加载、显示、隐藏等不同阶段被触发。以下是一些主要的页面事件及其用途:
2.1下拉刷新事件
下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。
启用下拉刷新有两种方式:
① 全局开启下拉刷新
- 在 app.json 的 window 节点中,将 enablePullDownRefresh 设置为 true
② 局部开启下拉刷新
- 在页面的 .json 配置文件中,将 enablePullDownRefresh 设置为 true
在实际开发中,推荐使用第 2 种方式,为需要的页面单独开启下拉刷新的效果。
配置下拉刷新窗口的样式
在全局或页面的 .json 配置文件中,通过backgroundColor 和 backgroundTextStyle 来配置下拉刷新窗口的样式,其中:
- backgroundColor 用来配置下拉刷新窗口的背景颜色,仅支持16 进制的颜色值
- backgroundTextStyle 用来配置下拉刷新 loading 的样式,仅支持 dark 和 light
监听页面的下拉刷新事件
在页面的 .js 文件中,通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。
例如,在页面的 wxml 中有如下的 UI 结构,点击按钮可以让 count 值自增 +1:
<view>count值是:{
{
count}}</view>
<button bindtap="addCount">+1</button>
data: {
count: 0,
username: 'zs',
country: 'CHINA'
},
addCount() {
this.setData({
count: this.data.count + 1
})
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
// console.log('触发了message页面的下拉刷新')
this.setData({
count: 0
})
},
点击后count的值变为2
下拉刷新后值重新变为0
当处理完下拉刷新后,下拉刷新的 loading 效果会一直显示,不会主动消失,所以需要手动隐藏下拉刷新的loading 效果。此时,调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新。示例代码如下:
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
// console.log('触发了message页面的下拉刷新')
this.setData({
count: 0
})
wx.stopPullDownRefresh()
},
2.2上拉触底事件
上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。
在页面的 .js 文件中,通过 onReachBottom() 函数即可监听当前页面的上拉触底事件。示例代码如下:
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
console.log("小猿触发了上拉触底事件")
},
配置上拉触底距离
上拉触底距离指的是触发上拉触底事件时,滚动条距离页面底部的距离。
可以在全局或页面的 .json 配置文件中,通过 onReachBottomDistance 属性来配置上拉触底的距离。
小程序默认的触底距离是 50px,在实际开发中,可以根据自己的需求修改这个默认值
案例的实现步骤:
① 定义获取随机颜色的方法
Page({
/**
* 页面的初始数据
*/
data: {
colorList: []
},
getColors() {
// 需要展示 loading 效果
wx.showLoading({
title: '数据加载中...'
})
wx.request({
url: 'https://applet-base-api-t.itheima.net/api/color',
method: 'get',
success: ({
data: res }) => {
this.setData({
colorList: [...this.data.colorList, ...res.data]
})
}
})
},
② 在页面加载时获取初始数据
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
this.getColors()
},
③ 渲染 UI 结构并美化页面效果
<view wx:for="{
{colorList}}" wx:key="index" class="num-item" style="background-color: rgba({
{item}});">{
{
item}}</view>
/* pages/contact/contact.wxss */
.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: 1rpx 1rpx 6rpx #aaa;
color: black;
}
④ 在上拉触底时调用获取随机颜色的方法
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
this.getColors()
},
⑤ 添加 loading 提示效果
getColors() {
// 需要展示 loading 效果
wx.showLoading({
title: '数据加载中...'
})
wx.request({
url: 'https://applet-base-api-t.itheima.net/api/color',
method: 'get',
success: ({
data: res }) => {
this.setData({
colorList: [...this.data.colorList, ...res.data]
})
},
complete: () => {
wx.hideLoading() //隐藏loading效果
}
})
},
⑥ 对上拉触底进行节流处理
在微信小程序开发中,对上拉触底(onReachBottom事件)进行节流处理是出于以下几个原因:
-
防止频繁触发
用户在滚动页面到底部时可能会快速多次触发上拉触底事件,如果没有节流处理,可能会导致多次加载相同的数据,增加不必要的网络请求和服务器的负担。 -
提升用户体验
如果用户每次轻微上拉都会触发加载,那么用户体验会非常糟糕。通过节流,可以确保在一定时间内只触发一次加载,让用户有更好的使用体验。 -
节省资源
频繁的网络请求会消耗大量的数据流量和CPU资源,对用户的设备性能和网络状况都是一种负担。节流可以减少这些不必要的消耗。 -
避免错误
在短时间内频繁触发事件可能会导致代码执行错误,比如重复发送网络请求,可能会导致服务器响应错误或者小程序崩溃。 -
控制加载节奏
有些时候,数据加载是需要一定时间间隔的,比如等待服务器生成新的数据。节流可以控制加载的节奏,避免在数据尚未准备好时进行加载。
步骤:
在 data 中定义 isloading 节流阀
⚫ false 表示当前没有进行任何数据请求
⚫ true 表示当前正在进行数据请求
data: {
colorList: [],
isloding: false
},
在 getColors() 方法中修改 isloading 节流阀的值
⚫ 在刚调用 getColors 时将节流阀设置 true
⚫ 在网络请求的 complete 回调函数中,将节流阀重置为 false
this.setData({
isloding: true
})
在 onReachBottom 中判断节流阀的值,从而对数据请求进行节流控制
⚫ 如果节流阀的值为 true,则阻止当前请求
⚫ 如果节流阀的值为 false,则发起数据请求
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
if (this.data.isloding) return
this.getColors()
},
3.生命周期
生命周期(Life Cycle)是指一个对象从创建 -> 运行 -> 销毁的整个阶段,强调的是一个时间段。例如:
- 张三出生,表示这个人生命周期的开始
- 张三离世,表示这个人生命周期的结束
- 中间张三的一生,就是张三的生命周期
我们可以把每个小程序运行的过程,也概括为生命周期:
- 小程序的启动,表示生命周期的开始
- 小程序的关闭,表示生命周期的结束
- 中间小程序运行的过程,就是小程序的生命周期
在小程序中,生命周期分为两类,分别是:
① 应用生命周期
- 特指小程序从启动 -> 运行 -> 销毁的过程
② 页面生命周期
- 特指小程序中,每个页面的加载 -> 渲染 -> 销毁的过程
其中,页面的生命周期范围较小,应用程序的生命周期范围较大,如图所示
生命周期函数:是由小程序框架提供的内置函数,会伴随着生命周期,自动按次序执行。
生命周期函数的作用:允许程序员在特定的时间点,执行某些特定的操作。例如,页面刚加载的时候,可以在onLoad 生命周期函数中初始化页面的数据。
注意:生命周期强调的是时间段,生命周期函数强调的是时间点。
小程序中的生命周期函数分为两类,分别是:
① 应用的生命周期函数
- 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数
② 页面的生命周期函数 - 特指小程序中,每个页面从加载 -> 渲染 -> 销毁期间依次调用的那些函数
小程序的应用生命周期函数需要在 app.js 中进行声明,示例代码如下:
//app.js
App({
/**
* 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
*/
onLaunch: function () {
// console.log('onLaunch')
},
/**
* 当小程序启动,或从后台进入前台显示,会触发 onShow
*/
onShow: function (options) {
// console.log('onShow')
},
/**
* 当小程序从前台进入后台,会触发 onHide
*/
onHide: function () {
// console.log('onHide')
},
/**
* 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息
*/
onError: function (msg) {
}
})
小程序的页面生命周期函数需要在页面的 .js 文件中进行声明,示例代码如下:
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
this.getColors()
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
},
/**
* 生命周期函数--监听页面显示
*/
onShow: function () {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
if (this.data.isloding) return
this.getColors()
},
/**
* 用户点击右上角分享
*/
onShareAppMessage: function () {
}
})
4.WXS脚本
WXS(WeiXin Script)是小程序独有的一套脚本语言,结合 WXML,可以构建出页面的结构。
wxml 中无法调用在页面的 .js 中定义的函数,但是,wxml 中可以调用 wxs 中定义的函数。因此,小程序中
wxs 的典型应用场景就是“过滤器”。
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 对象
为了降低 wxs(WeiXin Script)的学习成本, wxs 语言在设计时借大量鉴了 JavaScript 的语法。但是本质上,wxs 和 JavaScript 是完全不同的两种语言!
5、案例-本地生活(列表页面)
列表页面的 API 接口
以分页的形式,加载指定分类下商铺列表的数据:
① 接口地址
⚫ https://applet-base-api-t.itheima.net
/categories/:cate_id/shops
⚫ URL 地址中的 :cate_id 是动态参数,表示分类的 Id
② 请求方式
⚫ GET 请求
③ 请求参数
⚫ _page 表示请求第几页的数据
⚫ _limit 表示每页请求几条数据
判断是否还有下一页数据
如果下面的公式成立,则证明没有下一页数据了:
页码值 * 每页显示多少条数据 >= 总数据条数
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)
课件及源码获取方式:
关注公众号:小猿搜码
后台发送:csdn小程序
即可免费领取