微信小程序页面路由跳转总结（wx.navigateTo、wx.redirectTo、wx.switchTab、wx.reLaunch、wx.navigateBack 的区别）

一、页面路由

微信官方文档 · 页面路由

在小程序中所有页面的路由全部由框架进行管理。框架以栈的形式维护了当前的所有页面。

---

二、路由方式

wx.navigateTo

用于保留当前页面、跳转到应用内的某个页面，但是不能跳到 tabbar 页面。使用 wx.navigateBack 可以返回到原页面。

对于页面不是特别多的小程序，通常推荐使用 wx.navigateTo 进行跳转， 以便返回原页面，以提高加载速度。当页面特别多时，则不推荐使用。

注意：小程序中页面栈最多十层。

使用方式：

下面进行一个简单的路由跳转，具体使用方式请移步至：wx.navigateTo

使用API：

// home/index.js
wx.navigateTo({
  url: 'page/test/index?id=1',
})

// text/index.js
Page({
  onLoad: function(option){
    console.log(option.id)
  }
})
1
2
3
4
5
6
7
8
9
10
11

使用组件：

<navigator 
	url="/page/navigate/navigate?title=navigate" 
	open-type="navigateTo"
>跳转到新页面</navigator>
1
2
3
4

wx.redirectTo

当页面过多时，被保留页面会挤占微信分配给小程序的内存，或是达到微信所限制的 5 层页面栈。

这时，我们应该考虑选择 wx.redirectTo。wx.redirectTo() 用于关闭当前页面，跳转到应用内的某个页面。这样的跳转，可以避免跳转前页面占据运行内存，但返回时页面需要重新加载，增加了返回页面的显示时间。

使用方式：

下面进行一个简单的路由跳转，具体使用方式请移步至：wx.redirectTo

使用API：

wx.redirectTo({
  url: 'page/test/index?id=1',
})
1
2
3

使用组件：

<navigator 
	url="../../redirect/redirect/redirect?title=redirect" 
	open-type="redirect" 
>在当前页打开</navigator>
1
2
3
4

wx.reLaunch

wx.reLaunch() 与上面的 wx.redirectTo() 的用途基本相同。wx.reLaunch()先关闭了内存中所有保留的页面，再跳转到目标页面。

使用方式：

下面进行一个简单的路由跳转，具体使用方式请移步至：wx.reLaunch

使用API：

wx.reLaunch({
  url: 'page/test/index?id=1',
})
1
2
3

使用组件：

<navigator 
	url="../../reLaunch/reLaunch/reLaunch?title=reLaunch" 
	open-type="reLaunch" 
>重启动</navigator>
1
2
3
4

wx.switchTab

对于跳转到 tabBar 的页面，最好选择 wx.switchTab()，它会先关闭所有非 tabBar 的页面。其次，也可以选择 wx.reLaunch()，它也能实现从非 tabBar 跳转到 tabBar 页面，或在 tabBar 间跳转，效果等同 wx.switchTab()。使用其他跳转 API 来跳转到 tabBar，则会跳转失败。

使用方式：

下面进行一个简单的路由跳转，具体使用方式请移步至：wx.switchTab

使用API：

// app.json
{
  "tabBar": {
    "list": [{
      "pagePath": "index",
      "text": "首页"
    },{
      "pagePath": "other",
      "text": "其他"
    }]
  }
}

// other.js
wx.switchTab({
  url: '/index'
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

使用组件：

<navigator 
	url="/page/index/index" 
	open-type="switchTab" 
>切换 Tab</navigator>
1
2
3
4

wx.navigateBack

用于关闭当前页面，并返回上一页面或多级页面。开发者可通过 getCurrentPages() 获取当前的页面栈，决定需要返回几层。

这个 API 需要填写的参数只有 delta，表示要返回的页面数。若 delta 的取值大于现有可返回页面数时，则返回到用户进入小程序的第一个页面。当不填写 delta 的值时，就默认其为 1（注意，默认并非取 0），即返回上一页面。

只有调用 navigateTo 跳转页面时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。

使用方式：

下面进行一个简单的路由跳转，具体使用方式请移步至：wx.navigateBack

使用API：

// 此处是A页面
wx.navigateTo({
  url: 'B?id=1'
})

// 此处是B页面
wx.navigateTo({
  url: 'C?id=1'
})

// 在C页面内 navigateBack，将返回A页面
wx.navigateBack({
  delta: 2
  // delta: 1   =>  将返回B页面
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

使用组件：

<navigator 
	url="/page/index/index" 
	open-type="navigateBack" 
>页面返回</navigator>
1
2
3
4

---

总结

我们应该根据我们项目的实际应用场景来选择路由跳转的方式。