目录

弹窗概述

弹窗一般指打开应用时自动弹出或者用户行为操作时弹出的UI界面,用于短时间内展示用户需关注的信息或待处理的操作。

从ArkUI组件树层级上来看,Overlay浮层、弹窗、模态、带Order的Overlay浮层都挂载在Root节点下。弹窗、模态、带Order的Overlay浮层根据设置的层级(数字大小)进行逐层显示,并且全部显示在Overlay浮层上面。如图所示:

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

而Dialog、Popup、Menu、OverlayManager、Toast、bindSheet以及bindContentCover的组件在结合路由、导航使用时存在如下几种显示模式。

弹窗的种类

根据用户交互操作场景,弹窗可分为模态弹窗和非模态弹窗两种类型,其区别在于用户是否必须对其做出响应。

当前模态弹窗通过设置指定属性变成非模态,例如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的能力差异,并提供了隐私弹窗、进度弹窗等常见场景的实现方案,帮助开发者完成弹窗选型与开发。

规格约束