基础库 2.16.1 开始支持,低版本需做兼容处理。
页面路由器对象。可以通过 this.pageRouter
或 this.router
获得当前页面或自定义组件的路由器对象。
页面路由器有 switchTab
reLaunch
redirectTo
navigateTo
navigateBack
五个方法,与 wx 对象向同名的五个方法 switchTab
reLaunch
redirectTo
navigateTo
navigateBack
功能相同;唯一的区别是,页面路由器中的方法调用时,相对路径永远相对于 this
指代的页面或自定义组件。
例如,对于下面这段示例代码:
// index/index.js
Page({
wxNavAction: function () {
wx.navigateTo({
url: './new-page'
})
},
routerNavAction: function () {
this.pageRouter.navigateTo({
url: './new-page'
})
}
})
页面 index/index
的 js 代码如上所示。如果此时已经跳转到了一个新页面 pack/index
,然后才调用到上面的 wxNavAction
方法,跳转的新页面路径将是 pack/new-page
;而如果调用的是 routerNavAction
方法,跳转的新页面路径仍然是 index/new-page
。
换而言之, this.pageRouter
获得的路由器对象具有更好的基路径稳定性。通常情况下,使用 this.pageRouter.navigateTo
代替 wx.navigateTo
是更优的。