【微信小程序】页面导航

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)
}