HarmonyOS Next实战##HarmonyOS SDK应用服务##教育
目标：封装自定义弹窗，通过方法调用，直接打开已定制的确认弹窗。
知识点：
- 由于CustomDialogController在使用上存在诸多限制，不支持动态创建也不支持动态刷新，在相对较复杂的应用场景中推荐使用UIContext中获取到的PromptAction对象提供的openCustomDialog接口来实现自定义弹出框。
- 弹出框（openCustomDialog）可以通过配置isModal来实现模态和非模态弹窗。isModal为true时，弹出框为模态弹窗。isModal为false时，弹出框为非模态弹窗。
自定义弹出框的打开与关闭：
- 创建ComponentContent。ComponentContent用于定义自定义弹出框的内容。其中，wrapBuilder(buildText)封装自定义组件，new Params(this.message)是自定义组件的入参，可以缺省，也可以传入基础数据类型。
- 打开自定义弹出框。通过调用openCustomDialog接口打开的弹出框默认为customStyle为true的弹出框，即弹出框的内容样式完全按照contentNode自定义样式显示。
- 关闭自定义弹出框。由于closeCustomDialog接口需要传入待关闭弹出框对应的ComponentContent。因此，如果需要在弹出框中设置关闭方法，则可参考完整示例封装静态方法来实现。关闭弹出框之后若需要释放对应的ComponentContent，则需要调用ComponentContent的dispose方法。
实战：
PromptActionClass
import {
BusinessError } from '@kit.BasicServicesKit';
import {
ComponentContent, promptAction } from '@kit.ArkUI';
import {
UIContext } from '@ohos.arkui.UIContext';
export class PromptActionClass {
static ctx: UIContext;
static contentNode: ComponentContent<Object>;
static options: promptAction.BaseDialogOptions;
static setContext(context: UIContext) {
PromptActionClass.ctx = context;
}
static setContentNode(node: ComponentContent<Object>) {
PromptActionClass.contentNode = node;
}
static setOptions(options: promptAction.BaseDialogOptions) {
PromptActionClass.options = options;
}
static openDialog() {
if (PromptActionClass.contentNode !== null) {
PromptActionClass.ctx.getPromptAction().openCustomDialog(PromptActionClass.contentNode, PromptActionClass.options)
.then(() => {
console.info('OpenCustomDialog complete.')
})
.catch((error: BusinessError) => {
let message = (error as BusinessError).message;
let code = (error as BusinessError).code;
console.error(`OpenCustomDialog args error code is ${
code}, message is ${
message}`);
})
}
}
static closeDialog() {
if (PromptActionClass.contentNode !== null) {
PromptActionClass.ctx.getPromptAction().closeCustomDialog(PromptActionClass.contentNode)
.then(() => {
console.info('CloseCustomDialog complete.')
})
.catch((error: BusinessError) => {
let message = (error as BusinessError).message;
let code = (error as BusinessError).code;
console.error(`CloseCustomDialog args error code is ${
code}, message is ${
message}`);
})
}
}
static updateDialog(options: promptAction.BaseDialogOptions) {
if (PromptActionClass.contentNode !== null) {
PromptActionClass.ctx.getPromptAction().updateCustomDialog(PromptActionClass.contentNode, options)
.then(() => {
console.info('UpdateCustomDialog complete.')
})
.catch((error: BusinessError) => {
let message = (error as BusinessError).message;
let code = (error as BusinessError).code;
console.error(`UpdateCustomDialog args error code is ${
code}, message is ${
message}`);
})
}
}
}
CustomConfirmDialog
import {
PromptActionClass } from "./PromptActionClass";
import {
ComponentContent } from "@kit.ArkUI";
export class CustomConfirmDialog{
static init(ctx: UIContext){
PromptActionClass.setContext(ctx);
PromptActionClass.setContentNode(new ComponentContent(ctx, wrapBuilder(buildText), '请确认信息：例如删除、授权等敏感操作'));
PromptActionClass.setOptions({
alignment: DialogAlignment.Top, offset: {
dx: 0, dy: 50 } });
}
static open(){
PromptActionClass.openDialog()
}
}
@Builder
function buildText(message: string) {
Column({
space: 10 }) {
Row() {
Text('温馨提示').fontSize(14)
}
Text(message)
.fontSize(24)
Row({
space: 20 }) {
Button('取消')
.backgroundColor(Color.Gray)
.onClick(() => {
PromptActionClass.closeDialog()
})
Button('确认')
.onClick(() => {
PromptActionClass.closeDialog()
})
}
.width('100%')
.justifyContent(FlexAlign.Center)
}
.backgroundColor('#FFF0F0F0')
.padding(10)
.margin(20)
.borderRadius(8)
.clip(true)
}
ConfirmDialogDemoPage
import {
CustomConfirmDialog } from './CustomConfirmDialog';
@Entry
@Component
struct ConfirmDialogDemoPage {
private ctx: UIContext = this.getUIContext();
aboutToAppear(): void {
CustomConfirmDialog.init(this.ctx)
}
build() {
Row() {
Column() {
Button("打开确认弹窗")
.margin({
top: 50 })
.onClick(() => {
CustomConfirmDialog.open()
})
}
.width('100%')
.height('100%')
}
.height('100%')
}
}
