微信小程序开发文档 微信小程序 页面路由

2024-02-25 开发教程 微信小程序开发文档 匿名 4

页面路由

在小程序中所有页面的路由全部由框架进行管理。

页面栈

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

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

开发者可以使用 getCurrentPages()函数获取当前页面栈。

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

页面栈示例:页面栈遵循先进后出的规则,当前也在最上面。

路由方式

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

路由方式触发时机路由前页面路由后页面
初始化小程序打开的第一个页面onLoad, onShow
打开新页面

调用 API wx.navigateTo

使用组件 <navigator open-type="navigateTo"/>

onHideonLoad, onShow
页面重定向

调用 API wx.redirectTo

使用组件 <navigator open-type="redirectTo"/>

onUnloadonLoad, onShow
页面返回

调用 API wx.navigateBack

使用组件<navigator open-type="navigateBack">

用户按左上角返回按钮

onUnloadonShow
Tab 切换

调用 API wx.switchTab

使用组件 <navigator open-type="switchTab"/>

用户切换 Tab

各种情况请参考下表
重启动

调用 API wx.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()

Tips:

  • navigateTo, redirectTo只能打开非 tabBar页面。
  • switchTab只能打开tabBar页面。
  • reLaunch可以打开任意页面。
  • 页面底部的 tabBar由页面决定,即只要是定义为 tabBar的页面,底部都有 tabBar
  • 调用页面路由带的参数可以在目标页面的onLoad中获取。