小程序的页面导航

168 阅读3分钟

「这是我参与2022首次更文挑战的第10天,活动详情查看:2022首次更文挑战

什么是页面导航

页面导航指的是页面之间的相互跳转


页面导航的俩种方式

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

声明式导航

导航到 tabBar 页面

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

  • 指定 url 属性和 open-type 属性

    • url 表示要导航的页面地址,必须以 / 开头
    • open-type 表示导航的方式,必须为 switchTab
    <navigator url="/pages/message/message" open-type="switchTab">导航到tabBar中的message页面</navigator>
    

导航到非 tabBar 页面

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

  • 指定 url 属性和 open-type 属性

    • url 表示要导航的页面地址,必须以 / 开头
    • open-type 表示导航的方式,必须为 navigate(一般默认是导航到非 tabBar 页面,所以可以省略不写)
    <navigator url="/pages/Info/Info" open-type="navigate">导航到非tabBar页面</navigator>
    

后退导航

  • 如果要后退到上一页或多级页面,则需要指定 open-type 属性和 delta 属性
    • open-type 的值必须是 navigateBack,表示要进行后退导航
    • delta 的值必须是数字,表示要后退的层级(如果只是后退到上一页,那么可以不用 delta 属性,默认delta 的值就是1)
<navigator open-type="navigateBack">返回上一页</navigator>

编程式导航

导航到 tabBar 页面

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

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

页面结构(.wxml 文件)

<button bindtap="gotoMessage"> 跳转到 tabBar 页面 </button>

页面数据(.js 文件)

gotoMessage() {
    wx.switchTab({
        url: '/pages/message/message'
    })
},

导航到非 tabBar 页面

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

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

页面结构(.wxml 文件)

<button bindtap="gotoInfo"> 跳转到非tabBar页面 </button>

页面数据(.js 文件)

gotoInfo(){
    wx.navigateTo({
        url: '/pages/Info/Info'
    })
},

后退导航

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

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

页面结构(.wxml 文件)

<button bindtap="back"> 返回上一页 </button>

页面数据(.js 文件)

back(){
    wx.navigateBack({
        delta: 1,
    })
},

导航传参

声明式导航传参

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

  • 参数和路径之间使用?分隔
  • 参数键与参数值用 = 相连
  • 不同参数用 & 分隔
<navigator url="/pages/Info/Info?name=kaka&age=20">跳转到 info 页面</navigator>

编程式导航传参

调用 wx.navigateTo(Object Object) 方法跳转页面时,可以携带参数:

页面结构(.wxml 文件)

<button bindtap="gotoInfo"> 跳转到 info 页面 </button>

页面数据(.js 文件)

gotoInfo(){
    wx.navigateTo({
        url: '/pages/Info/Info?name=kaka&age=20'
    })
},

在 onLoad 中接收导航参数

通过导航传递过来的参数,可以直接在 onLoad 事件中直接获取

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