一、页面导航介绍
1.1 什么是页面导航
页面导航 指的是页面之间的相互跳转。例如,浏览器中实现页面导航的方式有如下两种 <a>
链接和location.href
1.2 小程序中实现页面导航的两种方式
1. 声明式导航
在页面上声明一个<navigator>
导航组件,通过点击<navigator>
组件实现页面跳转
2. 编程式导航
调用小程序的导航 API,实现页面的跳转
1.3 声明式导航
1.3.1 什么是声明导航
在浏览器中,点击链接实现导航的方式,叫做声明式导航。如:普通网页中点击链接,vue中点击都属于声明式导航
1.3.2 导航到 tabBar 页面
tabBar 页面 指的是 被配置为 tabBar 的页面。
在使用<navigator>
组件跳转到指定的 tabBar 页面时,需要指定①url 属性和 open-type 属性,其中:url 表示要跳转的页面的地址, 必须以 / 开头。②open-type 表示跳转的方式 ,必须为 switchTab
示例代码如下:
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面
</navigator>
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的 tabBar 页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
1.3.3 导航到非tabBar 页面
非tabBar 页面 指的是没有被配置为 tabBar 的页面。
在使用<navigator>
组件跳转到普通的非 tabBar 页面时,则需要指定 url 属性和 open-type 属性,其中:url 表示要跳转的页面的地址, 必须以 / 开头open-type 表示跳转的方式, 必须为 navigate
注意:为了简便,在导航到非 tabBar 页面时, open-type=“navigate” 属性可以省略
1.3.4 后退导航
如果要后退到上一页面或多级页面,则需要指定 open-type 属性和 delta 属性,其中:open-type 的值必须是 navigateBack,表示要进行后退导航delta 的值必须是数字,表示要后退的层级
<navigator open-type="navigateBack" delta="1">后退到上一页</navigator>
注意:为了简便,如果只是后退到上一页面,则 可以省略 delta 属性 ,因为其 默认值就是 1 。
1.4 编程式导航
1.4.1 什么是编程式导航
编程式导航: 在浏览器中,调用API方法实现导航的方式,叫做编程式导航。如:普通网页中调用location.href跳转到新页面的方式,属于编程式导航。
1.4.2 导航到 tabBar 页面
调用 wx.switchTab(Object object) 方法,可以跳转到 tabBar 页面。其中 Object 参数对象的属性列表如下
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面
</navigator>
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的 tabBar 页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
home.wxml 页面结构:
<button bindtap="gotoMessage">跳转到message页面</button>
home.js 编程式导航:
//通过编程式导航跳转到tabBar页面
gotoMessage() {
wx.switchTab({
url: '/pages/message/message',
})
},
<navigator url="/pages/info/info" open-type="navigate">导航到info页面</navigator>
<navigator open-type="navigateBack" delta="1">后退到上一页</navigator>
1.4.3 导航到非 tabBar 页面
调用 wx.navigateTo(Object object) 方法,可以跳转到非 tabBar 的页面。其中 Object 参数对象的属性
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 否 | 需要跳转的 tabBar 页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
<navigator url="/pages/info/info" open-type="navigate">导航到info页面</navigator>
1.4.4 后退导航
调用 wx.navigateBack(Object object) 方法,可以返回上一页面或多级页面。其中 Object 参数对象
可选的属性列表如下
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
delta | number | 否 | 返回的页面数,如果 delta 大于现有页面数,则返回到首页 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
home.wxml 页面结构:
<button bindtap="gotoBack">后退</button>
home.js 编程式导航:
gotoInfo(){
wx.navigateBack({
delta:1
})
},