【小程序基础】页面导航

236 阅读3分钟

1. 实现页面导航的方式

声明式导航

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

2. 声明式导航

1. 导航到 tabBar 页面

tabBar 页面指的是被配置为 tabBar 的页面。
在使用 组件跳转到指定的 tabBar 页面时,需要指定 url 属性和 open-type 属性,其中:

  • 1.url 表示要跳转的页面的地址,必须以 / 开头
  • 2.open-type 表示跳转的方式,必须为 switchTab
    示例:
<navigator url="pages/message/message" open-type="switchTab">跳转到message</navigator>

2. 导航到非 tabBar 页面

非 tabBar 页面指的是没有被配置为 tabBar 的页面。
在使用 组件跳转到普通的非 tabBar 页面时,则需要指定 url 属性和 open-type 属性,其中:

  • 1.url 表示要跳转的页面的地址,必须以 / 开头
  • 2.open-type 表示跳转的方式,必须为 navigate
    示例:
<navigator url="pages/message/message" open-type="navigate">跳转到message</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 参数对象的属性列表如下:

属性类型是否必选说明
urlstring需要跳转的 tabBar 页面的路径,路径后不能带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

2. 导航到非 tabBar 页面

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

属性类型是否必选说明
urlstring需要跳转到的非 tabBar 页面的路径,路径后可以带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

3. 后退导航

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

属性类型是否必选说明
deltanumber返回的页面数,默认1,如果 delta 大于现有页面数,则返回到首页
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

导航传参

1. 声明式导航传参

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

<navigator url="pages/message/message?type=1">跳转到message</navigator>

2. 编程式导航传参

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

wx.navigateTo({
    url: 'pages/message/message?type=1'
})

3. 在 onLoad 中接收导航参数

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