快应用 页面启动模式

2020-08-10 11:00 更新

用于定义页面的启动行为

静态声明

在 manifest 文件中页面路由信息 router.page 可增加启动模式字段 launchMode,用于声明该页面的启动模式

页面启动模式参数:

属性 类型 默认值 必填 描述
launchMode 1050+ String standard 声明页面的启动模式,支持"singleTask","standard"两种页面启动模式。
标识为"singleTask"模式时每次打开目标页面都会打开已有的目标页面并回调onRefresh生命周期函数,清除该页面上打开的其他页面,没有打开过此页面时会创建新的目标页面实例。
标识为"standard"模式时会每次打开新的目标页面(多次打开目标页面地址时会存在多个相同页面)

示例:

"router": {
    "entry": "PageA",
    "pages": {
      "PageA": {
        "launchMode": "singleTask",
        "component": "index"
      },
      "PageB": {
        "launchMode": "standard",
        "component": "index"
      },
      "PageC": {
        "launchMode": "singleTask",
        "component": "index"
      }
    }
  }

打开页面的行为逻辑:

若按顺序启动 PageA -> PageB -> PageC -> PageB -> PageC -> PageA

  • 打开 PageA,首次打开时页面栈为空 ​页面栈为​PageA
  • 打开 PageB,PageB 的启动模式为 standard,即在 PageA 之上新建 PageB 的页面实例并显示 ​页面栈为​​PageA​,​PageB
  • 打开 PageC,首次打开 PageC,即在 PageB 之上新建 PageC 的页面实例并显示 ​页面栈为​​PageA​,​PageB​,​PageC
  • 打开 PageB,PageB 的启动模式为 standard,即在 PageC 之上新建 PageB 的页面实例并显示 ​页面栈为​PageA​,​PageB​,​PageC​,​PageB
  • 打开 PageC,PageC 页面实例已存在,即销毁 PageC 之上的页面实例 PageB,回到之前打开的 PageC 的页面实例并回调此页面生命周期的 onRefresh 函数 ​页面栈为PageA​,​PageB​,​PageC
  • 打开 PageA,PageA 页面实例已存在,即销毁 PageA 之上的页面实例 PageB 和 PageC,回到之前打开的 PageA 的页面实例并回调此页面生命周期的 onRefresh 函数 ​页面栈为PageA

动态声明

动态声明有两种方式。一种是在 router.push 中携带启动标识参数,另一种是在打开页面的链接中携带启动标识参数。启动标识参数可以控制页面打开行为。

页面启动标识参数:

参数 类型 必填 说明
___PARAMLAUNCH_FLAG\__1050+ String 跳转快应用页面时传递的页面参数。携带clearTask时启动目标页面会清除此页面外的其他页面,存在多个目标页面时只保留最先打开的目标页面并回调onRefresh生命周期。如不存在目标页面时将清除所有页面并新建目标页面实例。

示例:

// `1050+` 以'clearTask'标识启动页面
router.push({
  uri: '/PageB',
  params: {
    ___PARAM_LAUNCH_FLAG___: 'clearTask'
  }
})

打开页面的行为逻辑:

若已经打开页面栈为 PageA -> PageB -> PageC,此时以clearTask标识启动PageB

  • 销毁 PageC 页面实例
  • 销毁 PageA 页面实例
  • PageB 页面实例已存在,回到此页面实例并回调此页面生命周期的 onRefresh 函数 若已经打开页面栈为 PageA -> PageC,此时以 clearTask 标识启动 PageB
  • 销毁 PageC 页面实例
  • 销毁 PageA 页面实例
  • PageB 页面实例不存在,新建 PageB 页面实例并显示


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号