鸿蒙5.0开发进阶：ArkTS组件-弹出框 (Dialog)

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

弹出框 (Dialog)

弹出框是一种模态窗口，通常用于在保持当前的上下文环境时，临时展示用户需关注的信息或待处理的操作，用户在模态弹出框内完成上述交互任务。模态弹出框需要用户进行交互才能够退出模态模式。

说明

该组件从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

导入模块

import { TipsDialog, SelectDialog, ConfirmDialog, AlertDialog, LoadingDialog, CustomContentDialog } from '@kit.ArkUI'

子组件

无

属性

不支持通用属性

TipsDialog

TipsDialog({controller: CustomDialogController, imageRes: Resource, imageSize?: SizeOptions, title?: ResourceStr, content?: ResourceStr, checkTips?: ResourceStr, ischecked?: boolean, checkAction?: (isChecked: boolean) => void, primaryButton?: ButtonOptions, secondaryButton?: ButtonOptions})

提示弹出框，即为带图形确认框，必要时可通过图形化方式展现确认框。

装饰器类型：@CustomDialog

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

名称	参数类型	必填	装饰器类型	说明
controller	CustomDialogController	否	-	提示弹出框控制器。 说明： 未使用@Require装饰，构造时不强制校验参数。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
imageRes	ResourceStr12+ | PixelMap12+	是	-	展示的图片。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
imageSize	SizeOptions	否	-	自定义图片尺寸。 默认值：64*64vp 元服务API： 从API version 11开始，该接口支持在元服务中使用。
title	ResourceStr	否	-	提示弹出框标题。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
content	ResourceStr	否	-	提示弹出框内容。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
checkTips	ResourceStr	否	-	checkbox的提示内容。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
isChecked	boolean	否	@Prop	value为true时，表示checkbox已选中，value为false时，表示未选中。 默认值：false 元服务API： 从API version 11开始，该接口支持在元服务中使用。
checkAction12+	(isChecked: boolean) => void	否	-	现推荐使用 onCheckedChange12+。 元服务API： 从API version 12开始，该接口支持在元服务中使用。
onCheckedChange12+	Callback<boolean>	否	-	checkbox的选中状态改变事件。 元服务API： 从API version 12开始，该接口支持在元服务中使用。
primaryButton	ButtonOptions	否	-	提示框左侧按钮。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
secondaryButton	ButtonOptions	否	-	提示框右侧按钮。 元服务API： 从API version 11开始，该接口支持在元服务中使用。
theme12+	Theme | CustomTheme	否	-	主题信息，可以是CustomTheme或从onWillAp