小程序页面导航

页面导航

1.什么是页面导航

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

1. <a>链接
2. location.herf

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

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

页面导航 - 声明式导航

1.导航到tabBar页面

tabBar页面指的是被配置为tabBar的页面。

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

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

示例代码如下：

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

​

2.导航到非tabBar页面

非tabBar页面指的是没有被配置为tabBar的页面。

在使用<navigator>组件跳转到普通的非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属性和delta属性，其中：

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

示例代码如下：

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

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

页面导航-编程式导航

1.导航到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'
	})
}

2.导航到非tabBar页面

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

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

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

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

3.后退导航

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

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

// 页面结构
<button bindtap="gotoBack">后退</button>

// 通过编程式导航，后退到上一页面
gotoBack() {
	wx.navigateBack()
}

页面导航-导航传参

1.声明式导航

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

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

代码示例如下：

<navigator url="/pages/info/info?name=zs&age=20">跳转到info页面</navigator>

2.编程式导航传参

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

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

// 通过编程式导航，跳转到 info 页面 ，并携带参数
gotoInfo2() {
	wx.navigateTo({
		url:'/pages/info/info?name=ls&gender=男'
	})
}

3.在onLoad中接收导航参数

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

// 生命周期函数--监听页面加载

onLoad:function(option) {
	// options 就是导航传递过来的参数对象
	console.log(options)
}

页面事件-下拉刷新事件

1.什么是下拉刷新

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

2.启用下拉刷新

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

1. 全局开启下拉刷新

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

2. 局部开启下拉刷新

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

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

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

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

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

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

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

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

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

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

5.停止下拉刷新的效果

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

// 页面相关事件处理函数 -- 监听用户下拉动作
onPullDownRefresh:function(){
	this.setData({
		count:0
	})
	// 当数据重置成功之后，调用此函数，关闭下拉刷新效果
	wx.stopPullDownRefresh()
}

页面事件-下拉刷新事件

1.什么是上拉触底

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

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

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

// 页面上拉触底事件的处理函数
onReachBottom:function(){
	console.log('触发了上拉触底事件')
}

3.配置上拉触底距离

上拉触底距离指的是触发上拉触底事件时，滚动条距离页面底部的距离。

可以在全局或页面的.json配置文件中，通过onReachBottomDistance属性来配置上拉触底的距离。

小程序默认的触底距离是50px，在实际开发中，可以根据自己的需求修改这个默认值。