路由方式

页面栈

框架以栈的形式维护了当前的所有页面。 当发生路由切换的时候,页面栈的表现如下:

路由方式页面栈表现
初始化新页面入栈
打开新页面新页面入栈
页面重定向当前页面出栈,新页面入栈。
页面返回页面不断出栈,直到目标返回页。
Tab 切换页面全部出栈,只留下新的 Tab 页面。

getCurrentPages()

getCurrentPages() 函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。

代码示例

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

页面切换路径过多,详细示例请在开发者工具中的控制台查看。

Tip:

不要尝试修改页面栈,会导致路由以及页面状态错误。

路由方式

对于路由的触发方式以及页面生命周期函数如下:

路由方式触发时机路由前页面路由后页面
初始化智能小程序打开的第一个页面onLoad, onShow
打开新页面调用 API swan.navigateTo 或使用组件 < navigator open-type=”navigateTo”/ >onHideonLoad, onShow
页面重定向调用 API swan.redirectTo 或使用组件 < navigator open-type=”redirectTo”/ >onUnloadonLoad, onShow
Tab 切换调用 API swan.switchTab 或使用组件 < navigator open-type=”switchTab”/ > 或用户切换 Tab各种情况请参考下表
页面返回调用 API swan.navigateBack 或使用组件 < navigator open-type=”navigateBack”/ > 或用户按左上角返回按钮onUnloadonShow
重启动调用 API swan.reLaunch 或使用组件 < navigator open-type=”reLaunch”/ >onUnloadonLoad, onShow

同时点击页面重定向和重启动跳转到下一个页面后无法返回。

Tab 切换对应的生命周期(以 A、B 页面为 Tabbar 页面,C 是从 A 页面打开的页面,D 页面是从 C 页面打开的页面为例):

当前页面路由后页面触发的生命周期(按顺序)
AANothing happend
ABA.onHide(), B.onLoad(), B.onShow()
AB(再次打开)A.onHide(), B.onShow()
CAC.onUnload(), A.onShow()
CBC.onUnload(), B.onLoad(), B.onShow()
DBD.onUnload(), C.onUnload(), B.onLoad(), B.onShow()
D(从转发进入)AD.onUnload(), A.onLoad(), A.onShow()
D(从转发进入)BD.onUnload(), B.onLoad(), B.onShow()

代码示例

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

建议在开发者工具中的控制台查看,工具与真机略有差异,以真机的生命周期为准。

说明

  • navigateTo、redirectTo 只能打开非 tabBar 页面。
  • switchTab 只能打开 tabBar 页面。
  • reLaunch 可以打开任意页面。
  • 页面底部的 tabBar 由页面决定,即只要是定义为 tabBar 的页面,底部都有 tabBar 。
  • reLaunch、redirectTo、navigateTo 可在需要跳转的应用内页面路径后带参数。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如path?key=value&key2=value2,如果跳转的页面路径是 tabBar 页面则不能带参数。
  • 调用页面路由带的参数可以在目标页面的 onLoad、onShow 中获取,具体获取方法见下方代码示例。

代码示例

  • JS
  1. // 目标页面
  2. Page({
  3. // 在 onLoad 中获取
  4. onLoad: function (options) {
  5. console.log(options);
  6. },
  7. // 在 onShow 中获取
  8. onShow: function() {
  9. // 获取当前小程序的页面栈
  10. let pages = getCurrentPages();
  11. // 数组中索引最大的页面--当前页面
  12. let currentPage = pages[pages.length - 1];
  13. // 打印出当前页面中的 options
  14. console.log(currentPage.options);
  15. }
  16. });