【微信小程序】声明式导航

一、页面导航介绍

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