当前位置：首页 > news >正文

HarmonyOS Next中的弹出框使用

news 来源：原创 2025/8/7 21:33:24

HarmonyOS Next弹出框概述及分类

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

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

本文主要是介绍自定义弹出框的使用，固定样式弹出框可以参考官方文档，自定义弹出框主要有两种实现方式：

1、基础自定义弹出框 (CustomDialog)（不推荐）

2、不依赖UI组件的全局自定义弹出框 (openCustomDialog)（推荐）

基础自定义弹出框 (CustomDialog)

CustomDialog是自定义弹出框，可用于广告、中奖、警告、软件更新等与用户交互响应操作。通过CustomDialogController类显示自定义弹窗。使用弹窗组件时，可优先考虑自定义弹窗，便于自定义弹窗的样式与内容。

1、@CustomDialog装饰器

使用@CustomDialog装饰器装饰自定义弹出框，可在此装饰器内自定义弹出框内容。这里在装饰器内添加确定和取消按钮，也可以同时添加数据函数。

@CustomDialog
struct CustomDialogExample {cancel?: () => voidconfirm?: () => voidcontroller: CustomDialogControllerbuild() {Column() {Text('我是内容').fontSize(20).margin({ top: 10, bottom: 10 })Flex({ justifyContent: FlexAlign.SpaceAround }) {Button('cancel').onClick(() => {this.controller.close()if (this.cancel) {this.cancel()}}).backgroundColor(0xffffff).fontColor(Color.Black)Button('confirm').onClick(() => {this.controller.close()if (this.confirm) {this.confirm()}}).backgroundColor(0xffffff).fontColor(Color.Red)}.margin({ bottom: 10 })}}
}

创建构造器，与装饰器呼应相连。页面内需要在构造器内进行接收，同时创建相应的函数操作。

@Entry
@Component
struct CustomDialogUser {dialogController: CustomDialogController = new CustomDialogController({builder: CustomDialogExample({cancel: ()=> { this.onCancel() },confirm: ()=> { this.onAccept() },}),})onCancel() {console.info('Callback when the first button is clicked')}onAccept() {console.info('Callback when the second button is clicked')}build() {Column() {Button('click me').onClick(() => {this.dialogController.open()})}.width('100%').margin({ top: 5 })}
}

2、CustomContentDialog

使用CustomContentDialog自定义弹出框，可在此自定义内容区弹出框，同时支持定义操作区按钮样式。从API version 12开始支持使用。

名称	类型	必填	装饰器类型	说明
controller	CustomDialogController	是	-	弹出框控制器。说明：未使用@Require装饰，构造时不强制校验参数。
contentBuilder	() => void	是	@BuilderParam	弹出框内容。
primaryTitle	ResourceStr	否	-	弹出框标题。
secondaryTitle	ResourceStr	否	-	弹出框辅助文本。
localizedContentAreaPadding	LocalizedPadding	否	-	弹出框内容区内边距。
contentAreaPadding	Padding	否	-	弹出框内容区内边距。设置了localizedContentAreaPadding属性时该属性不生效。
buttons	ButtonOptions[]	否	-	弹出框操作区按钮，最多支持4个按钮。
theme	Theme\| CustomTheme	否	-	主题信息，可以是CustomTheme或从onWillApplyTheme中获取的Theme实例。
themeColorMode	ThemeColorMode	否	-	自定义弹窗深浅色模式。

支持自定义内容弹出框，包含contentBuilder、buttons等内容。和@CustomDialog装饰器一样，CustomContentDialog也可以添加按钮和数据，如果需要完全自定义弹框样式，可以只设置contentBuilder函数参数用来实现自定义弹框。

import { CustomContentDialog } from '@kit.ArkUI'@Entry
@Component
struct Index {dialogController: CustomDialogController = new CustomDialogController({builder: CustomContentDialog({primaryTitle: '标题',secondaryTitle: '辅助文本',contentBuilder: () => {this.buildContent();},buttons: [{ value: '按钮1',buttonStyle: ButtonStyleMode.TEXTUAL, action: () => {console.info('Callback when the button is clicked')}},{value: '按钮2',buttonStyle: ButtonStyleMode.TEXTUAL,role: ButtonRole.ERROR}],}),});build() {Column() {Button("支持自定义内容弹出框").onClick(() => {this.dialogController.open()})}.width('100%').height('100%').justifyContent(FlexAlign.Center)}// 自定义弹出框的内容区@BuilderbuildContent(): void {Column() {Text('内容区')}.width('100%')}
}

不依赖UI组件的全局自定义弹出框 (openCustomDialog)

先对于CustomDialogController，官方更推荐我们使用openCustomDialog来实现自定义弹出框。

由于CustomDialogController在使用上存在诸多限制，不支持动态创建也不支持动态刷新，在相对较复杂的应用场景中推荐使用UIContext中获取到的PromptAction对象提供的openCustomDialog接口来实现自定义弹出框。

弹出框（openCustomDialog）存在两种入参方式创建自定义弹出框：

openCustomDialog（传参为ComponentContent形式）：通过ComponentContent封装内容可以与UI界面解耦，调用更加灵活，可以满足开发者的封装诉求。拥有更强的灵活性，弹出框样式是完全自定义的，且在弹出框打开之后可以使用updateCustomDialog方法动态更新弹出框的一些参数。
openCustomDialog（传builder的形式）：相对于ComponentContent，builder必须要与上下文做绑定，与UI存在一定耦合。此方法有用默认的弹出框样式，适合于开发者想要实现与系统弹窗默认风格一致的效果。

1、初始化弹出框配置

获取PromptAction对象,初始化弹出框配置，可在配置中修改弹窗位置，动画等相关配置。

创建ComponentContent，ComponentContent用于定义自定义弹出框的内容。其中，wrapBuilder(radioDialogView)封装自定义组件。

  // 设置对话框内容组件（支持链式调用）init(context: UIContext, radioSelectBean: RadioSelectBean): RadioAppDialog {this.contentNode = new ComponentContent(context, wrapBuilder<[RadioSelectBean]>(radioDialogView), radioSelectBean);this.promptAction = context.getPromptAction();this.options = {alignment: DialogAlignment.Bottom,transition: TransitionEffect.move(TransitionEdge.BOTTOM).animation({ duration: 300 }),}return this}

2、打开自定义弹出框。

通过调用openCustomDialog接口打开的弹出框默认为customStyle为true的弹出框，即弹出框的内容样式完全按照contentNode自定义样式显示。

 // 显示自定义对话框show() {if (this.contentNode !== null) {this.promptAction?.openCustomDialog(this.contentNode, this.options).then(() => {console.info('打开自定义对话框完成')}).catch((error: BusinessError) => {// 错误处理：获取错误码和信息let message = (error as BusinessError).message;let code = (error as BusinessError).code;console.error(`打开对话框参数错误，错误码：${code}，信息：${message}`);})}}

3、关闭自定义弹出框

关闭弹出框之后若需要释放对应的ComponentContent，则需要调用ComponentContent的dispose方法。

tip:关闭弹出框需要传人待关闭的ComponentContent对象。

 // 关闭自定义对话框close() {if (this.contentNode !== null) {this.promptAction?.closeCustomDialog(this.contentNode).then(() => {this.contentNode?.dispose()console.info('关闭自定义对话框完成')}).catch((error: BusinessError) => {let message = (error as BusinessError).message;let code = (error as BusinessError).code;console.error(`关闭对话框参数错误，错误码：${code}，信息：${message}`);})}}

4、更新自定义弹出框的内容

若需要更新弹出框中自定义组件的内容可以通过ComponentContent提供的update方法来实现。这里传人的数据对象就事显示的时候传人的数据。

  //更新对话框数据updateData(radioSelectBean: RadioSelectBean) {this.contentNode?.update(radioSelectBean)}

5、完整代码

// 导入ArkUI的对话框操作模块和基础服务错误类型
import { ComponentContent, curves, PromptAction, promptAction } from "@kit.ArkUI";
import { BusinessError } from "@kit.BasicServicesKit";
import { RadioSelectBean } from "../model/HomeModel";
import { radioDialogView } from "../view/GlobalBuildView";// 自定义单选对话框类
export class RadioAppDialog {// 单例实例private static instance: RadioAppDialog;// 静态属性声明contentNode?: ComponentContent<Object>; // 对话框内容组件options?: promptAction.BaseDialogOptions; // 对话框基础配置选项promptAction?: PromptAction// 私有化构造函数private constructor() {console.info('创建自定义对话框单例');}/*** 获取单例实例（静态方法）* @returns 返回全局唯一实例*/public static getInstance(): RadioAppDialog {if (!RadioAppDialog.instance) {RadioAppDialog.instance = new RadioAppDialog();}return RadioAppDialog.instance;}/*** 重置单例实例（用于测试或特殊场景）*/public static resetInstance(): void {RadioAppDialog.instance = new RadioAppDialog();}// 设置对话框内容组件（支持链式调用）init(context: UIContext, radioSelectBean: RadioSelectBean): RadioAppDialog {this.contentNode = new ComponentContent(context, wrapBuilder<[RadioSelectBean]>(radioDialogView), radioSelectBean);this.promptAction = context.getPromptAction();this.options = {alignment: DialogAlignment.Bottom,transition: TransitionEffect.move(TransitionEdge.BOTTOM).animation({ duration: 300 }),}return this}// 设置对话框选项（支持链式调用）setOptions(options: promptAction.BaseDialogOptions): RadioAppDialog {this.options = options;return this;}//更新对话框数据updateData(obj?: Object) {this.contentNode?.update(obj)}// 显示自定义对话框show() {if (this.contentNode !== null) {this.promptAction?.openCustomDialog(this.contentNode, this.options).then(() => {console.info('打开自定义对话框完成')}).catch((error: BusinessError) => {// 错误处理：获取错误码和信息let message = (error as BusinessError).message;let code = (error as BusinessError).code;console.error(`打开对话框参数错误，错误码：${code}，信息：${message}`);})}}// 关闭自定义对话框close() {if (this.contentNode !== null) {this.promptAction?.closeCustomDialog(this.contentNode).then(() => {this.contentNode?.dispose()console.info('关闭自定义对话框完成')}).catch((error: BusinessError) => {let message = (error as BusinessError).message;let code = (error as BusinessError).code;console.error(`关闭对话框参数错误，错误码：${code}，信息：${message}`);})}}// 更新对话框配置updateDialog(options: promptAction.BaseDialogOptions) {if (this.contentNode !== null) {this.promptAction?.updateCustomDialog(this.contentNode, options).then(() => {console.info('更新对话框配置完成')}).catch((error: BusinessError) => {let message = (error as BusinessError).message;let code = (error as BusinessError).code;console.error(`更新对话框参数错误，错误码：${code}，信息：${message}`);})}}
}

HarmonyOS Next中的弹出框使用

HarmonyOS Next弹出框概述及分类弹出框是一种模态窗口，通常用于在保持当前上下文环境的同时，临时展示用户需关注的信息或待处理的操作。用户需在模态弹出框内完成相关交互任务之后，才能退出模态模式。弹出框可以不与任何组件绑定&#xff0…...

编程日记 2025/8/7 21:33:24

Binder机制源码分析

Binder机制源码分析一、前言 Binder是Android系统中最重要的进程间通信机制，它不仅是应用程序和系统服务通信的基础，也是Android系统安全机制的重要组成部分。本文将深入分析Binder机制的实现原理，帮助读者理解Android系统的核心通信机制。…...

编程日记 2025/8/1 23:34:16

第5课树莓派的Python IDE—Thonny

1. Thonny的特点 Thonny是一款面向初学者的Python IDE。它由爱沙尼亚的 Tartu 大学开发，其调试器是专为学习和教学编程而设计的。Thonny具有如下特点易于上手。Thonny 内置了 Python 3.7，因此只需要一个简单的安装程序，你就可以开始学习编程了（如有必要，您还可以使用单独…...

编程日记 2025/8/7 21:30:28

位运算题目：或运算的最小翻转次数

文章目录题目标题和出处难度题目描述要求示例数据范围解法思路和算法代码复杂度分析题目标题和出处标题：或运算的最小翻转次数出处：1318. 或运算的最小翻转次数难度 4 级题目描述要求给定三个正整数 a \texttt{a} a、 b \texttt{b} b…...

编程日记 2025/8/4 4:33:15

Java 实现排序算法 TopK 问题

1. 低级排序 （1）冒泡排序（Bubble Sort） 思路： 每次从左到右冒泡，把最大的数推到最后。 public class BubbleSort {public static void bubbleSort(int[] arr) {int n arr.length;for (int i 0; i <…...

编程日记 2025/8/7 11:40:17

【JavaEE】网络编程socket

1.❤️❤️前言~🥳🎉🎉🎉 Hello, Hello~ 亲爱的朋友们👋👋，这里是E绵绵呀✍️✍️。如果你喜欢这篇文章，请别吝啬你的点赞❤️❤️和收藏📖📖。如果你对我的…...

编程日记 2025/8/6 8:09:59

第J3周：DenseNet121算法实现01（Pytorch版）

🍨 本文为🔗365天深度学习训练营中的学习记录博客🍖 原作者：K同学啊目标具体实现 （一）环境语言环境：Python 3.10 编译器: PyCharm 框架: Pytorch （二）具体步骤…...

编程日记 2025/8/7 21:31:12

在Ubuntu20.04上交叉编译能在Windows上运行的Qt5应用

参考链接： https://blog.csdn.net/Interview_TC/article/details/146050419 https://bugreports.qt.io/browse/QTBUG-82592 重要设置 sudo update-alternatives --config x86_64-w64-mingw32-g 选择后缀带posix的，（/usr/bin/x86_64-w64-min…...

编程日记 2025/8/7 1:46:41

C语言中，memmove和memcpy的区别？

文章目录 1. 内存重叠处理memcpy：memmove： 2. 性能差异总结在C语言中，memmove和memcpy均用于内存块的复制，但关键区别在于对内存重叠的处理： 1. 内存重叠处理 memcpy： 假设源（src&#xff0…...

编程日记 2025/8/4 17:26:54

小程序API —— 54 路由与通信 - 编程式导航

在小程序中实现页面的跳转，有两种方式： 声明式导航：navigator 组件编程式导航：使用小程序提供的 API 编程式导航 API 提供了五个常用的 API 方法： wx.navigateTo()：保留当前页面，跳转到应用内…...

编程日记 2025/8/7 21:28:02

2025 使用docker部署centos7容器并且需要centos7容器能通过ssh登录SSH 登录的CentOS7容器

以下是使用 Docker 部署可 SSH 登录的 CentOS7 容器的步骤： 1.创建 Dockerfile（保存为 Dockerfile.centos7）： vim Dockerfile.centos7 #复制如下内容 FROM centos:7# 备份原有的 yum 源配置文件 RUN mv /etc/yum.repos.d/CentO…...

编程日记 2025/8/7 21:26:46

docker安装向量数据库Milvus及可视化工具 Attu

前置条件 1.安装了docker 2.服务器网络正常，可以连接到容器下载地址 3.服务器磁盘空间正常，docker磁盘占用过大，请参考docker容量占用过大解决办法一、下载yml文件可在文章资源下载或者自行下载：下载yml 下载这个单机版本的…...

编程日记 2025/8/6 22:19:29

从模拟到现实：Sensodrive高精度力反馈技术赋能物流运输的高效与安全

在现代物流行业中，司机短缺、二氧化碳排放增加和利润空间紧张等问题日益凸显。为应对这些挑战，Sensodrive的SensoWheel和SensoPedals产品在自驾卡车中的应用，提供了更为高效的运输解决方案，有效缓解了这些问题。 Fernride公司利用…...

编程日记 2025/8/7 20:01:39

无需qt-creator,使用Trae从0到1生成qt的开发、构建、调试环境

一、安装 Qt 开发环境确保已经安装了 Qt，没有安装的可以自己在网上搜索怎么安装，安装时可选择不安装qt creator，但是qt开发库和编译器要安装，这里我选择的编译器是MinGW， 安装好以后，记录下qt开发库和Min…...

编程日记 2025/8/7 13:59:12

整理和总结微信小程序的高频知识点

前言近期萌生了一些想法，感觉可以做一个小程序作为产出。但小程序做得比较少，因此边做边复习。整理和总结了一些高频知识点和大家一起分享。一、模板和组件 1.1模板（Template） 优势简单灵活：模板定义和使用都较…...

编程日记 2025/8/5 20:39:53

VMware主机换到高配电脑，高版本系统的问题

原来主机是i3 ,windows7系统，vmware 14.0,虚机系统是ubuntu 14.04。目标新机是i7 14700KF,windows11系统。原以为安装虚拟机，将磁盘文件，虚拟机配置文件拷贝过去可以直接用。新目标主机先安装了vmware 15，运行原理虚机&#xff0…...

编程日记 2025/8/5 9:19:28

“锈化”Python：用Rust重塑Python生态的六大工具深度解析

前言：为何“锈化”Python？ Python以其简洁的语法和强大的生态系统成为数据科学、Web开发和自动化领域的首选语言。然而，随着项目规模和性能需求的增长，Python的一些传统工具在速度、内存效率和安全性上面临瓶颈。近年来&#xff…...

编程日记 2025/8/4 11:24:31

6.3考研408数据结构中BFS与DFS的易错点及难点解析

一、广度优先算法（BFS）易错点队列操作失误未正确处理节点入队顺序（如未按层序逐层扩展），导致结果混乱。在出队后未立即标记节点为已访问，可能引发重复访问（尤其在存在环的图中）。示…...

编程日记 2025/8/1 5:25:33

在Ubuntu上安装MEAN Stack的4个步骤

在Ubuntu上安装MEAN Stack的4个步骤为：1.安装MEAN；2.安装MongoDB；3.安装NodeJS，Git和NPM；4.安装剩余的依赖项。什么是MEAN Stack？ 平均堆栈一直在很大程度上升高为基于稳健的基于JavaScript的开发堆栈。…...

编程日记 2025/8/7 5:19:12

如何通过Odoo 18创建与配置服务器操作

如何通过Odoo 18创建与配置服务器操作服务器操作是Odoo实现业务流程自动化的核心工具，允许你在服务器端执行自动化任务，通常由按钮点击或自动化工作流等事件触发。这些操作使用 Python 编写，能够执行复杂的业务逻辑，从而增强 Od…...

编程日记 2025/8/3 19:18:17

【QGIS_Python】在QGIS的Python控制台生成SHP格式点数据并显示标注

参考文章： 「GIS教程」使用DeepSeek辅助QGIS快速制图 | 麻辣GIS 示例代码说明：使用参考文章中的省会城市坐标点，左侧增加一列城市序号code, 图层标注显示 code 城市名称，同时在指定路径下生成对应SHP格式点数据。 import os fr…...

编程日记 2025/8/2 13:25:25

torcharrow gflags版本问题

问题描述其实仍然是很简单的编译问题，但是又弄了一整个下午加几乎整个晚上，进度缓慢，又吸取了教训，因而还是来记录一下。在试图使用torcharrow进行推荐系统模拟的时候，撰写的python程序报错：ERROR: flag…...

编程日记 2025/8/5 5:14:22

Spring IoC DI入门

一、Spring，Spring Boot和Spring MVC的联系及区别 Spring是另外两个框架的基础，是Java生态系统的核心框架，而SpringMVC是Spring 的子模块，专注于 Web 层开发，基于 MVC 设计模式（模型-视图-控制器&#xff…...

编程日记 2025/8/5 5:44:08

Vala编程语言教程-语言元素

语言元素方法在Vala中，函数无论是否定义在类内部均称为方法。下文将统一使用“方法”这一术语。 int method_name(int arg1, Object arg2) {return 1; } 此代码定义了一个名为 method_name 的方法，接受两个参数（一个整数值，一…...

编程日记 2025/8/2 13:30:54

数据可信安全流通实战，隐语开源社区Meetup武汉站开放报名

隐语开源社区 Meetup 系列再出发！2025 年将以武汉为始发站，聚焦"技术赋能场景驱动"，希望将先进技术深度融入数据要素流转的各个环节，推动其在实际应用场景中落地生根，助力释放数据要素的最大潜能&#xff01…...

编程日记 2025/8/5 22:17:26

windows 10 系统配置Node

目录什么是Node.js 什么是Npm Node.js环境搭建下载解压配置环境变量 npm配置如何运行下载的Node.js项目什么是Node.js 在 Node.js 之前，JavaScript 只能运行在浏览器中，作为网页脚本使用，为网页添加一些特效，或者和…...

编程日记 2025/8/6 17:56:24

2025年Postman的五大替代工具

虽然Postman是一个广泛使用的API测试工具，但许多用户在使用过程中会遇到各种限制和不便。因此，可能需要探索替代解决方案。本文介绍了10款强大的替代工具，它们能够有效替代Postman，成为你API测试工具箱的一部分。什么是Postman&…...

编程日记 2025/8/2 13:42:27

城市街拍人像自拍电影风格Lr调色教程，手机滤镜PS+Lightroom预设下载！

调色教程城市街拍人像自拍的电影风格 Lr 调色，是利用 Adobe Lightroom 软件，对在城市街景中拍摄的人像自拍照片进行后期处理，使其呈现出电影画面般独特的视觉质感与艺术氛围。通过一系列调色操作，改变照片的色彩、明暗、对比等元…...

编程日记 2025/8/5 16:48:53

HTML图像标签的详细介绍

1. 常用图像格式格式特点适用场景JPEG有损压缩，文件小，不支持透明适合照片、复杂图像PNG无损压缩，支持透明（Alpha通道）适合图标、需要透明背景的图片GIF支持动画，最多256色简单动画、低色彩图标WebP谷歌开…...

编程日记 2025/8/1 14:43:48

C++进阶——红黑树的实现

目录 1、红黑树的概念 1.1 红黑树的定义 1.2 红黑树的规则 1.3 为什么没有一条路径会比其他路径长出两倍 1.4 红黑树的性能 2、红黑树的实现 2.1 红黑树的结构 2.2 红黑树的插入 2.2.1 红黑树插入一个值的大概过程 2.2.2 情况1：变色 2.2.3 情况2&#xff…...

编程日记 2025/8/1 23:00:13

Linux 文件操作-标准IO函数1-文件指针、文件缓冲区(行缓冲、全缓冲、无缓冲)的验证

目录 1.文件指针 2.文件缓冲区 2.1 行缓冲 2.2. 全缓冲 2.3. 无缓冲 3. 程序验证： （1）main.c执行test1(),打印hello world，不加 \n 换行符 （2）刷新缓冲区方法1：使用\n （3&am…...

编程日记 2025/8/5 8:13:55

中国历史文化名城分布矢量数据

中国，这片古老而厚重的土地，承载着上下五千年的文明，从北国的冰天雪地到南疆的热带雨林，从东海之滨的波涛汹涌到西域大漠的风沙漫天，无数的历史文化名城如繁星般散布其间。它们是岁月长河中沉淀下来的瑰宝&#xff0…...

编程日记 2025/8/3 7:57:55

蓝桥杯十天冲刺-day1（日期问题）

日期问题基础循环遍历模板对于蓝桥杯所有的日期问题遍历，都可以使用的上 for(year2000;year<2022;year) for(month1;month<12;month) for(day1;day<31;day) {if(month1||month3||month5||month7||month8||month10||month12);else if(month2){if((year…...

编程日记 2025/7/31 23:57:52

漏洞知识点《Tornado框架中RequestHandler的对象》

Tornado框架中RequestHandler的所有对象 [SUPPORTED_METHODS, _INVALID_HEADER_CHAR_RE, __class__, __delattr__, __dict__, __dir__, __doc__, __eq__, __format__, __ge__, __getattribute__, __gt__, __hash__, __init__, __init_subclass__, __le__, __lt__, __module__,…...

编程日记 2025/8/7 14:41:02