目录

实现页面级弹出框的功能

问题现象

使用自定义弹窗功能时,在特殊场景下,需要弹窗开启状态下进行页面跳转。用Navigation导航或者router导航在弹窗内跳转到新页面时,会遇到弹窗显示在所有的新入栈的页面上的问题。

背景知识

弹窗的定义可参考官方文档:弹窗概述,常见弹窗实现方式可以分为以下几种:

  1. 自定义弹窗(CustomDialog)是一种基础自定义弹窗,通过CustomDialogController控制。使用弹窗组件时,可自定义弹窗的样式与内容。
  2. @ohos.promptAction(弹窗)是一种不依赖UI组件的全局自定义弹出框,从API18开始,由于上下文不明确部分接口废弃,建议使用UIContext中的getPromptAction方法获取当前UI上下文关联的PromptAction对象。并且可以通过配置isModal来实现模态和非模态弹窗。isModal为true时,弹出框为模态弹窗。isModal为false时,弹出框为非模态弹窗。
  3. @ohos.window(窗口)提供管理窗口的一些基础能力,包括对当前窗口的创建、销毁、各属性设置,以及对各窗口间的管理调度。其中window.createWindow接口通过Configuration参数设置窗口属性。可通过windowType参数设置窗口类型为模态窗口以及子窗口等。
  4. 通过OverlayManager设置浮层的方式实现弹窗。
  5. 通过NavDestinationMode.DIALOG弹窗类型设置弹窗。此时整个NavDestination无组件占位部分默认透明显示。
  6. 创建模态窗口通过bindSheet等模态窗口属性实现弹窗效果。

路由跳转方式:

  1. Navigation导航是官方推荐路由方式。Navigation组件是路由导航的根视图容器,一般作为Page页面的根容器使用,其内部默认包含了标题栏、内容区和工具栏,其中内容区默认首页显示导航内容(Navigation的子组件)或非首页显示(NavDestination的子组件),首页和非首页通过路由进行切换。
  2. @ohos.router(页面路由)也是官方的一种路由方式,目前已不再演进,建议使用Navigation导航。

问题定位

分析结论

根本原因是弹窗的显示层级在Page页面上,由于不同导航方式实现逻辑不一致,所以不同的导航方式,可以通过不同的窗口实现方式,实现“页面级弹窗”。

修改建议

常见FAQ

Q:除以上方案外,是否还有其他方式可以实现页面级弹窗?

A:通过组件的通用zIndex/visibility属性以及if/else语法控制组件的显隐,模拟实现自定义弹窗效果,但是该方案并不推荐,系统已经封装有各种弹窗,层级、动效都有接口可控制,通过该方式实现弹窗过于复杂且不方便维护。

Q:怎样实现多层弹窗效果?

A:弹窗嵌套即可。可以使用官方弹窗组件CustomDialog嵌套CustomDialog;也可以在CustomDialog官方弹窗内采用本文方案混合使用,遵循谁后打开,谁显示在上层的原则。

Q:设置zIndex属性层级最高的情况下,为什么没效果?

A:zIndex是设置同层组件之间的渲染优先级权重,但不支持跨层比较权重。

Q:Navigation页面中,在弹出框的options入参中设置levelMode属性,页面级弹出框不生效?

A:弹窗层级控制本质上是弹窗所挂载的父节点不同,默认弹窗挂在Root节点下,所以层级最高,页面级弹窗中router路由需要挂载在Page节点下,而Navigation路由需要挂载在NavDestination节点下。所以页面级弹出框只能在NavDestination页面下,设置页面级弹框才会生效,即:在Navigation中嵌套NavDestination,然后在弹出框的options入参中设置levelMode属性,页面级弹出框就会生效。

Q:openCustomDialog的levelMode的属性在API15以下会程序报错。

A:在API15及以上版本中才支持的levelMode属性,当运行在低版本系统(API15以下)时会导致兼容性问题,可能直接触发异常或者存在闪退风险 (不能识别等问题)。