1# 弹出框概述 2<!--Kit: ArkUI--> 3<!--Subsystem: ArkUI--> 4<!--Owner: @houguobiao--> 5<!--Designer: @houguobiao--> 6<!--Tester: @lxl007--> 7<!--Adviser: @HelloCrease--> 8 9弹出框是一种模态窗口，通常用于在保持当前上下文环境的同时，临时展示用户需关注的信息或待处理的操作。用户需在模态弹出框内完成相关交互任务之后，才能退出模态模式。弹出框可以不与任何组件绑定，其内容通常由多种组件组成，如文本、列表、输入框、图片等，以实现布局。ArkUI当前提供了**自定义**和**固定样式**两类弹出框组件。 10 11* **自定义弹出框：** 开发者需要根据使用场景，传入自定义组件填充在弹出框中实现自定义的弹出框内容。主要包括基础自定义弹出框 (CustomDialog)、不依赖UI组件的自定义弹出框 (openCustomDialog)。 12* **固定样式弹出框：** 开发者可使用固定样式弹出框，指定需要显示的文本内容和按钮操作，完成简单的交互效果。主要包括警告弹窗 (AlertDialog)、列表选择弹窗 (ActionSheet)、选择器弹窗 (PickerDialog)、对话框 (showDialog)、操作菜单 (showActionMenu)。 13 14## 使用场景 15 16| 名称 | 描述 | 17| --- | --- | 18|[不依赖UI组件的全局自定义弹出框 (openCustomDialog)](arkts-uicontext-custom-dialog.md) | 当用户需要在自定义弹出框内动态更新弹出框属性时使用。 | 19|[基础自定义弹出框 (CustomDialog)](arkts-common-components-custom-dialog.md) | 当用户需要自定义弹出框内的组件和内容时使用。 | 20| [警告弹窗 (AlertDialog)](arkts-fixes-style-dialog.md#警告弹窗-alertdialog) | 固定样式，通常用来展示用户当前需要或必须关注的信息或操作。如用户操作一个敏感行为时响应一个二次确认的弹出框。 | 21| [列表选择弹窗 (ActionSheet)](arkts-fixes-style-dialog.md#列表选择弹窗-actionsheet) | 固定样式，当用户需要关注或确认的信息存在列表选择时使用。 | 22|[选择器弹窗 (PickerDialog)](arkts-fixes-style-dialog.md#选择器弹窗-pickerdialog) | 固定样式，当用户需要在弹出框内选择日期、时间和文本时使用。 | 23| [对话框 (showDialog)](arkts-fixes-style-dialog.md#对话框-showdialog) | 固定样式，当用户需要处理弹出框响应后的异步返回结果时调用。 | 24| [操作菜单 (showActionMenu)](arkts-fixes-style-dialog.md#操作菜单-showactionmenu) | 固定样式，当用户需要处理操作菜单响应后的异步返回结果时调用。 | 25| [页面级弹出框](arkts-embedded-dialog.md) | 页面级弹出框，当用户期望弹出框跟随导航页面切换时使用。 | 26| [弹出框层级管理](arkts-dialog-levelorder.md) | 从API version 18开始，可以通过设置[levelOrder](../reference/apis-arkui/js-apis-promptAction.md#basedialogoptions11)参数来管理弹出框的显示顺序。 | 27| [弹出框控制器](arkts-dialog-controller.md) | 从API version 18开始，可设置controller参数以绑定[DialogController](../reference/apis-arkui/js-apis-promptAction.md#dialogcontroller18)控制器，通过控制器可以对弹出框进行操作。 | 28| [弹出框焦点策略](arkts-dialog-focusable.md) | 从API version 19开始，可以通过设置[focusable](../reference/apis-arkui/js-apis-promptAction.md#basedialogoptions11)参数来管理弹出框是否获取焦点。 | 29| [弹出框蒙层控制](arkts-dialog-mask.md) | 开发者可以通过设置maskColor、maskRect等参数来对弹出框蒙层进行定制。 | 30 31## 规格约束 32 33* 建议<!--Del-->在除[ServiceExtensionAbility](../../application-dev/application-models/serviceextensionability.md)等无UI界面的场景外，均<!--DelEnd-->使用[UIContext](../reference/apis-arkui/arkts-apis-uicontext-uicontext.md)中的弹出框方法。 34* 可以通过使用UIContext中的[getPromptAction](../reference/apis-arkui/arkts-apis-uicontext-uicontext.md#getpromptaction)方法获取当前UI上下文关联的[PromptAction](../reference/apis-arkui/arkts-apis-uicontext-promptaction.md)对象。 35* 由于系统安全管控原因，当弹出系统权限弹窗等场景时，弹出框在此状态下无法显示。 36 37 38