OpenHarmony应用开发之自定义弹窗

最新推荐文章于 2025-01-09 16:09:17 发布

OpenHarmony_小贾

最新推荐文章于 2025-01-09 16:09:17 发布

阅读量803

点赞数 26

CC 4.0 BY-SA版权

分类专栏： OpenHarmony 鸿蒙开发 HarmonyOS 文章标签： OpenHarmony 嵌入式硬件鸿蒙开发组件化移动开发应用开发 harmonyos

本文链接：https://blog.youkuaiyun.com/maniuT/article/details/139334420

应用场景

在应用的使用和开发中，弹窗是一个很常见的场景，自定义弹窗又因为极高的自由度得以广泛应用。本文以橘子购物中一个应用更新提示的弹窗介绍OpenHarmony的自定义弹窗。

接口

自定义弹窗官方文档：自定义弹窗-弹窗-全局UI方法-组件参考（基于ArkTS的声明式开发范式）-ArkTS API参考-HarmonyOS应用开发

CustomDialogController是自定义弹窗对应的接口，详细介绍如下：

CustomDialogController(value:{builder: CustomDialog, cancel?: () => void, autoCancel?: boolean, alignment?: DialogAlignment,
                      offset?: Offset, customStyle?: boolean, gridCount?: number, maskColor?: ResourceColor,
                      openAnimation?: AnimateParam, closeAnimation?: AnimateParam})

参数:

参数名	参数类型	必填	参数描述
builder	CustomDialog	是	自定义弹窗内容构造器。
cancel	() => void	否	点击遮障层退出时的回调。
autoCancel	boolean	否	是否允许点击遮障层退出。默认值：true
alignment	DialogAlignment	否	弹窗在竖直方向上的对齐方式。默认值：DialogAlignment.Default
offset	Offset	否	弹窗相对alignment所在位置的偏移量。
customStyle	boolean	否	弹窗容器样式是否自定义。默认值：false，弹窗容器的宽度根据栅格系统自适应，不跟随子节点；高度自适应子节点，最大为窗口高度的90%；圆角为24vp。
gridCount8+	number	否	弹窗宽度占栅格宽度的个数。默认为按照窗口大小自适应，异常值按默认值处理，最大栅格数为系统最大栅格数。