弹窗一般指打开应用时自动弹出或者用户行为操作时弹出的UI界面,用于短时间内展示用户需关注的信息或待处理的操作。
从ArkUI组件树层级上来看,Overlay浮层、弹窗、模态、带Order的Overlay浮层都挂载在Root节点下。弹窗、模态、带Order的Overlay浮层根据设置的层级(数字大小)进行逐层显示,并且全部显示在Overlay浮层上面。如图所示:

对于一个多页面应用,基本树结构如下所示。多个Page页面之间使用Router的接口进行跳转。NavBar和NavDestination组成的页面可以通过Navigation接口进行跳转。

而Dialog、Popup、Menu、OverlayManager、Toast、bindSheet以及bindContentCover的组件在结合路由、导航使用时存在如下几种显示模式。
弹窗显示在当前应用窗口最上层,层级高于应用主窗内所有页面(默认行为)。
如下图所示,触发弹窗显示时,弹窗层级要高于Page页面和Navigation页面,即如果弹窗组件没有被关闭的话,页面切换前后,弹窗组件都会显示在页面上方,而不会出现新的路由/导航页面覆盖在弹窗之上的情况。

如果Popup或Menu等存在绑定组件的弹窗组件,在页面跳转后因为所绑定的组件不在新页面显示,系统内部会自动关闭对应弹窗组件。但因为弹窗组件显示同时受开发者配置的参数控制,例如当Popup的show参数设置为显示时,弹窗组件会覆盖在下一个页面上显示。
弹窗显示在当前页面内,层级低于下一跳页面。
当开发者期望弹窗是一个页面内的弹窗,即当路由/导航切换页面时,弹窗会被跳转的页面覆盖,随着页面切回原页面,弹窗仍然正常显示。此时弹窗层级如下图所示:

弹窗显示在独立窗口内,窗口层级高于应用所在窗口。
在PC/2in1等设备上,开发者常期望弹窗的显示在应用窗口之外,此时需要借助子窗的能力。例如自定义弹窗可以通过CustomDialogControllerOptions中的showInSubWindow属性控制是否使用子窗功能。基于子窗显示的弹窗效果如下图所示。

此时弹窗组件的显示层级受窗口的层级管理控制,会高于当前应用所在的窗口,低于系统窗口(如系统输入法、系统弹窗等)。
根据用户交互操作场景,弹窗可分为模态弹窗和非模态弹窗两种类型,其区别在于用户是否必须对其做出响应。
当前模态弹窗通过设置指定属性变成非模态,例如AlertDialog,可以设置AlertDialogParam中的isModal属性值为false变成非模态,其他弹窗详见API说明。
不建议在非前台状态下,调用弹窗显示接口。
系统弹窗由系统弹出,出于安全考虑,不支持自定义样式。
系统弹窗出现时,调用非系统弹窗的显示接口(例如:promptAction的openCustomDialog、CustomDialogController的open等),禁止该类弹窗显示。
开发者可根据实际应用场景选择合适的弹窗进行页面开发。
| 弹窗名称 | 应用场景 |
|---|---|
| 弹出框(Dialog) | 当需要展示用户当前需要或必须关注的信息内容或操作时,例如二次退出应用等,应优先考虑使用此弹出框。 |
| 菜单(Menu/openMenu) | 当需要给用户提供可执行的操作时,例如长按图标展示操作选项等,应优先考虑使用此弹窗。 |
| 气泡提示(Popup/openPopup) | 当需要给用户提供提示时,例如点击一个问号图标弹出一段帮助提示等,应优先考虑使用此弹窗。 |
| 绑定模态页面(bindContentCover/bindSheet) | 当需要新的界面覆盖在旧的界面上,且旧的界面不消失的一种转场方式时,例如缩略图片点击后查看大图等,应优先考虑使用此弹窗。 |
| 即时反馈(Toast) | 当需要在一个小的窗口中提供用户当前操作的简单反馈时,例如提示文件保存成功等,应优先考虑使用此弹窗。 |
| 设置浮层(OverlayManager) | 当需要完全自定义内容、行为、样式时,可以使用浮层将UI展示在页面之上,例如音乐/语音播放悬浮球/胶囊等,应优先考虑使用此弹窗。 |
上表列出了各类弹窗的适用场景。实际开发中,在使用自定义弹窗能力时,还需考虑侧滑拦截、点击外部关闭、自定义动画、页面切换后弹窗保留、键盘避让等交互特性,不同弹窗方案对这些特性的支持程度各异。推荐阅读自定义弹窗选型与开发,该文对比了UIContext下面的openBindSheet、openCustomDialog、getOverlayManager弹窗与Navigation.Dialog的能力差异,并提供了隐私弹窗、进度弹窗等常见场景的实现方案,帮助开发者完成弹窗选型与开发。