一、结论

要实现禁止手势 / 外部点击关闭弹窗，核心依赖两个关键配置： 1、autoCancel 参数： 控制点击弹窗外部遮障层是否触发关闭，设置为 false 可直接禁用该关闭方式。

2、onWillDismiss 回调： 弹窗关闭前的拦截钩子，通过 DismissReason 枚举判断关闭原因，返回 false 可阻止弹窗关闭。

3、DismissReason 关键枚举值： PRESS_BACK：点击三键 back、侧滑（左滑 / 右滑）、键盘 ESC 触发的关闭； TOUCH_OUTSIDE：点击弹窗遮障层（外部区域）触发的关闭； CLOSE_BUTTON：点击弹窗内关闭按钮触发的关闭； 其他枚举（SLIDE_DOWN、SLIDE）：适配半模态转场的滑动关闭场景

二、代码实现和详细解释

1、基础配置：禁用外部点击+拦截手势关闭 核心逻辑是通过autoCancel禁用外部点击关闭，再利用onWillDismiss回调根据DismissReason拦截手势/返回键关闭，仅放行主动操作（如按钮点击）。

import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct DialogCloseTestPage {
  private customDialogComponentId: number = 0;

  @Builder
  customDialogComponent() {
    Column() {
      Text('弹窗内容区域Blablabla..').fontSize(20)
      Row({ space: 10 }) {
        Button('取消').onClick(() => {
          try {
            this.getUIContext().getPromptAction().closeCustomDialog(this.customDialogComponentId)
          } catch (error) {
            let message = (error as BusinessError).message;
            let code = (error as BusinessError).code;
            console.error(`closeCustomDialog error code is ${code}, message is ${message}`);
          }
        }).width(100).backgroundColor('#d5d5d5').fontColor('#707070')
        Button('确定').onClick(() => {
          try {
            this.getUIContext().getPromptAction().closeCustomDialog(this.customDialogComponentId)
          } catch (error) {
            let message = (error as BusinessError).message;
            let code = (error as BusinessError).code;
            console.error(`closeCustomDialog error code is ${code}, message is ${message}`);
          }
        }).width(100)
      }
    }.height(150).padding(20).justifyContent(FlexAlign.SpaceBetween)
  }

  build() {
    Column() {
      Button('禁止手势关闭弹窗')
        .margin({
          top: 100
        })
        .fontSize(30)
        .onClick(() => {
          this.getUIContext()
            .getPromptAction()
            .openCustomDialog({
              builder: () => {
                this.customDialogComponent()
              },
              onWillDismiss: (dismissDialogAction: DismissDialogAction) => {
                console.info('reason' + JSON.stringify(dismissDialogAction.reason));
                console.info('dialog onWillDismiss');
                // 返回手势
                if (dismissDialogAction.reason == DismissReason.PRESS_BACK) {
                  // dismissDialogAction.dismiss();
                }
                // 点击弹窗以外区域
                if (dismissDialogAction.reason == DismissReason.TOUCH_OUTSIDE) {
                  // dismissDialogAction.dismiss();
                }
              }
            })
            .then((dialogId: number) => {
              this.customDialogComponentId = dialogId;
            })
            .catch((error: BusinessError) => {
              console.error(`openCustomDialog error code is ${error.code}, message is ${error.message}`);
            })
        })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Start)
  }
}

关键参数说明：

引用资料地址

1、鸿蒙PromptAction官方文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-promptaction#promptactionopentoast18 2、鸿蒙自定义弹窗最佳实践：https://developer.huawei.com/consumer/cn/doc/architecture-guides/architecture-v1-3_2-ts_90-0000002444269041 3、鸿蒙页面返回键拦截：https://developer.huawei.com/consumer/cn/forum/topic/0201188750103330725?fid=0109140870620153026