1.1、什么是页面导航
页面导航指的是页面之间的相互跳转。例如,浏览器中实现页面导航的方式有如下两种:
- <a>链接
- location.href
1.2、小程序中实现页面导航的两种方式
(1)声明式导航
- 在页面上声明一个<navigator>导航组件
- 通过点击<navigator>组件实现页面跳转
(2)编程式导航
- 调用小程序的导航API,实现页面的跳转
声明式导航
2.1、导航到 tabBar 页面
tabBar页面指的是被配置为 tabBar 的页面
在使用<navigator>组件跳转到指定的tabBar页面时,需要指定url属性和open-type属性,其中:
- url表示要跳转的页面的地址,必须以 / 开头
- open-type 表示跳转的方式,必须为switchTab
示例代码如下:
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面</navigator>
2.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"属性可以省略
2.3、后退导航
如果要后退到上一页面或多级页面,则需要指定open-type 属性和 delta 属性,其中:
- open-type 的值必须是 navigateBack,表示要进行后退导航
- delta 的值必须是数字,表示要后退的层级
<navigator open-type="navigateBack" delta="1">返回上一页</navigator>
注意:为了简便,如果只是后退到上一页面,则可以省略delta属性,因为其默认值就是1。
编程式导航
3.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'
})
}
3.2、导航到非tabBar页面
调用wx.navigateTo(Object object)方法,可以跳转到非 tabBar 的页面。其中Object 参数对象的属性列表如下:
属性 | 类型 | 是否必选 | 说明 |
url | string | 是 | 需要跳转的非 tabBar 页面的路径,路径后可以带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败会执行) |
示例代码如下:
//页面结构
<button bindtap="gotoInfo">跳转到info页面</button>
//通过编程式导航,跳转到 info 页面
gotoInfo(){
wx.navigateTo({
url:"/pages/info/info"
})
}
3.3、后退导航
调用 wx.navigateBack(Object object)方法,可以返回上一页面或多级页面。其中 Object 参数对象 可选的属性列表如下:
属性 | 类型 | 默认值 | 是否必选 | 说明 |
delta | number | 1 | 否 | 返回的页面数,如果delta大于现有页面数,则返回到首页 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
//页面结构
<button bindtap="gotoBack">后退</button>
//编程式导航,后退到上一页面
gotoBack(){
wx.navigateBack({
delta:1
})
}
导航传参
4.1、声明式导航传参
navigator 组件的 url 属性用来指定将要跳转的页面的路径。同时,路径的后面还可以携带参数:
参数与路径之间使用 ?分隔
参数键与参数值用 = 相连
不同参数用 & 分隔
示例代码如下:
<navigator url="/pages/info/info?name=zs&age=20">跳转到info页面</navigator>
4.2、编程式导航传参
调用 wx.navigataTo(Object object)方法跳转页面时,也可以携带参数,代码示例如下:
//页面结构
<button bindtap="gotoInfo2">跳转到info页面</button>
//通过编程式导航,跳转到info页面,并携带参数
gotoInfo2(){
wx.navigateTo({
url:"/pages/info/info?name=zs&gender=男"
})
}
4.3、在 onLoad 中接受导航参数
通过声明式导航传参或编程式导航传参所携带的参数,可以直接在onLoad事件中直接获取到,示例代码如下:
//生命周期函数 —— 监听页面加载
onLoad:function(options){
//options 就是导航传递过来的参数对象
console.log(options)
}