小程序中页面导航的两种方式

  • 声明式导航
    (1)在页面上声明一个<navigator>导航组件

(2)通过点击<navigator>组件实现页面跳转

  • 编程式导航
    调用小程序的导航API,实现页面的跳转

声明式导航

导航到tabBar页面

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

  • url表示要跳转的页面的地址,必须以/开头。
  • open-type表示跳转的方式,必须为switchTab
    代码如下:
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面</navigator>

导航到非tabBar页面

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

  • url表示要跳转的页面的地址,必须以/开头
  • open-type表示跳转的方式,必须为navigate
    代码如下:
<navigator url="/pages/info/info" open-type="navigate">导航到info页面</navigator>

后退导航

如果需要后退到上一页面或多级页面,则需要指定open-type属性和delta属性,其中:

  • open-type的值必须是navigateBack,表示要进行后退导航
  • delta的值必须是数字,表示要后退的层级
    代码如下:
<navigator open-type="navigateBack" delta="1">返回</navigator>

编程式导航

导航到tabBar页面

  • 用法
    调用wx.switchTab(Object object)方法,可以跳转到tabBar页面。其中Object参数对象的属性列表如下:
属性类型是否必选说明
urlstring需要跳转的tabBar页面的路径,路径后不能带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数
  • 代码
<button bindtap="gotoMessage">跳转到消息页面</button>
gotoMessage(){
wx.switchTab({
url:'/pages/message/message'
})
}

导航到非tabBar页面

  • 用法
    调用wx.navigateTo(Object object)方法,可以跳转到非tabBar的页面。其中Object参数对象的属性列表如下:
属性类型是否必选说明
urlstring需要跳转到的非tabBar页面的路径,路径后可以带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数
  • 代码:
<button bindtap="gotoInfo">跳转到info页面</button>
gotoInfo(){
wx.navigateTo({
url:'/pages/info/info'
})
}

后退导航

  • 用法
    调用wx.navigateBack(Object object)方法,可以返回上一页面或多级页面。其中Object参数对象可选的属性列表如下:
属性类型默认值是否必选说明
deltanumber1返回的页面数,如果delta大于现有页面数,则返回到首页
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数
  • 代码
<button bindtap="gotoBack">后退</button>
gotoBack(){
wx.navigateBack()
}

导航传参

声明式导航传参

navigator组件的url属性用来指定将要跳转到的页面的路径。同时,路径的后面还可以携带参数:
(1)参数与路径之间使用?分隔
(2)参数键与参数值用=相连
(3)不同参数用&分隔

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

编程式导航传参

调用wx.navigateTo方法跳转页面也可携带参数,代码如下:

<button bindtap="gotoInfo2">跳转到info页面</button>
gotoInfo2(){
wx.navigateTo({
url:'/pages/info/info?name=zs&age=12'
})
}

在onLoad中接收导航参数

通过声明式导航传参或编程式导航传参所携带的参数,可以直接在onLoad事件中直接获取到,代码如下:

onLoad:function(options){
console.log(options)
}
最后修改:2022 年 02 月 17 日
如果觉得我的文章对你有用,请随意赞赏