大网数据广告活动
OpenHarmony 设备与应用开发

弹出框概述

· 52CE 我爱测

弹出框是一种模态窗口,通常用于在保持当前上下文环境的同时,临时展示用户需关注的信息或待处理的操作。弹出框可以不与任何组件绑定,其内容通常由多种组件组成,如文本、列表、输入框、图片等,以实现布局。ArkUI当前提供了**自定义**和**固定样式**两类弹出框组件。

弹出框概述

弹出框是一种模态窗口,通常用于在保持当前上下文环境的同时,临时展示用户需关注的信息或待处理的操作。弹出框可以不与任何组件绑定,其内容通常由多种组件组成,如文本、列表、输入框、图片等,以实现布局。ArkUI当前提供了自定义和固定样式两类弹出框组件。

  • 自定义弹出框: 开发者需要根据使用场景,传入自定义组件填充在弹出框中实现自定义的弹出框内容。主要包括基础自定义弹出框 (CustomDialog)、不依赖UI组件的自定义弹出框 (openCustomDialog)。
  • 固定样式弹出框: 开发者可使用固定样式弹出框,指定需要显示的文本内容和按钮操作,完成简单的交互效果。主要包括警告弹窗 (AlertDialog)、列表选择弹窗 (ActionSheet)、选择器弹窗 (PickerDialog)、对话框 (showDialog)、操作菜单 (showActionMenu)。

使用场景

名称 描述
不依赖UI组件的全局自定义弹出框 (openCustomDialog) 当用户需要在自定义弹出框内动态更新弹出框属性时使用。
基础自定义弹出框 (CustomDialog) 当用户需要自定义弹出框内的组件和内容时使用。
警告弹窗 (AlertDialog) 固定样式,通常用来展示用户当前需要或必须关注的信息或操作。如用户操作一个敏感行为时响应一个二次确认的弹出框。
列表选择弹窗 (ActionSheet) 固定样式,当用户需要关注或确认的信息存在列表选择时使用。
选择器弹窗 (PickerDialog) 固定样式,当用户需要在弹出框内选择日期、时间和文本时使用。
对话框 (showDialog) 固定样式,当用户需要处理弹出框响应后的异步返回结果时调用。
操作菜单 (showActionMenu) 固定样式,当用户需要处理操作菜单响应后的异步返回结果时调用。
页面级弹出框 页面级弹出框,当用户期望弹出框跟随导航页面切换时使用。
弹出框层级管理 从API version 18开始,可以通过设置levelOrder参数来管理弹出框的显示顺序。
弹出框控制器 从API version 18开始,可设置controller参数以绑定DialogController控制器,通过控制器可以对弹出框进行操作。
弹出框焦点策略 从API version 19开始,可以通过设置focusable参数来管理弹出框是否获取焦点。
弹出框蒙层控制 开发者可以通过设置maskColor、maskRect等参数来对弹出框蒙层进行定制。

规格约束

  • 建议在除ServiceExtensionAbility等无UI界面的场景外,均使用UIContext中的弹出框方法。
  • 可以通过使用UIContext中的getPromptAction方法获取当前UI上下文关联的PromptAction对象。
  • 由于系统安全管控原因,当弹出系统权限弹窗等场景时,弹出框在此状态下无法显示。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。