教程 框架 组件 接口 工具 其他

页面启动模式 1050+

用于定义页面的启动行为

静态声明

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

页面启动模式参数:

属性类型默认值必填描述
launchMode 1050+Stringstandard声明页面的启动模式,支持"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 中携带启动标识参数,另一种是在打开页面的链接中携带启动标识参数。启动标识参数可以控制页面打开行为。

页面启动标识参数:

参数类型必填说明
___PARAM_LAUNCH_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 页面实例并显示

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容