如何解决平板中多次点击按钮弹出多个弹窗导致弹窗区域背景色加深的问题
=================================

#### 问题现象

平板应用在横屏状态下，可以多次点击按钮弹出多个弹窗，弹窗区域的背景色跟随点击次数增加而加深。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ea/v3/IdqGNdPSTWuo7mUDzg_MnQ/zh-cn_image_0000002658969075.png?HW-CC-KV=V1&HW-CC-Date=20260709T134007Z&HW-CC-Expire=86400&HW-CC-Sign=32DCDBBE0BC1F0E05528FD87F78C4A5F46AED0447B068A7FC476935E221E0604 "点击放大")

#### 背景知识

*   [createSubWindow](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-window-windowstage#createsubwindow9-1)：可以根据WindowStage实例创建子窗口。
*   [loadContentByName](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-window-window#loadcontentbyname11)：根据指定路由页面名称为当前窗口加载命名路由页面。
*   [openCustomDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-uicontext-custom-dialog)：可以使用UIContext中获取到的PromptAction对象提供的openCustomDialog接口，在相对应用复杂的场景来实现自定义弹出框。可以通过配置isModal来实现模态和非模态弹窗。

#### 问题定位

排查弹窗创建的相关的代码。创建子窗时传递的参数是随时间动态变化的，每次点击操作都会随时间的变化创建新的子窗。moveWindowToAsync方法中传入的参数是固定值，所创建的子窗口的位置因此是固定的。多次点击，会在同一位置创建不同名字的窗口。

_// 创建子窗，每次创建时使用不同的子窗名字_
this.windowStage?.createSubWindow(\`subWindowDialog${Date.now()}\`).then((windowClass: window.Window) => {
  _// 子窗加载页面_
  _// 此处仅为示例，需要更换为实际页面，并通过LocalStorage传入状态属性_
  windowClass.loadContent('pages/DialogTest', new LocalStorage(), () => {
   _ // 设置子窗口的宽高，高度是屏幕高度的一半再减去导航条区域的高度_
    windowClass.resize(screen.width / 2, screen.height / 2 - this.getUIContext().vp2px(40));
 _   // 设置子窗口的背景色_
    windowClass.setWindowBackgroundColor('#33000000');
 _   // 移动子窗口的位置_
    windowClass.moveWindowToAsync(screen.width / 4, screen.height / 2);
  _  // 显示子窗口_
    windowClass.showWindow();
  });
});

#### 分析结论

在相同位置重复创建不同的有半透明背景色的子窗口，子窗口重叠，导致弹窗区域颜色加深。

#### 修改建议

*   调整createSubWindow的参数为固定值，保证窗口只创建一次，多次点击不会创建多个窗口，部分代码实现如下。
    
    _// 创建弹窗的方法，subWindow方案_
    _// 此处仅为示例，实际现象是仅平板横屏时弹窗未遮挡按钮_
    createWindow() {
     _ // 获取屏幕数据_
      const screen = display.getDefaultDisplaySync();
     _ // 创建子窗，传入固定的子窗名字_
      this.windowStage?.createSubWindow(\`subWindowDialog\`).then((windowClass: window.Window) => {
       _ // 子窗加载页面_
        _// 此处仅为示例，需要更换为实际页面，并通过LocalStorage传入状态属性_
        windowClass.loadContent('pages/DialogTest', new LocalStorage(), () => {
        _  // 设置子窗口的宽高，高度是屏幕高度的一半再减去导航条区域的高度_
          windowClass.resize(screen.width / 2, screen.height / 2 - this.getUIContext().vp2px(40));
      _    // 设置子窗口的背景色_
          windowClass.setWindowBackgroundColor('#ffffffff');
        _  // 移动子窗口的位置_
          windowClass.moveWindowToAsync(screen.width / 4, screen.height / 2);
        _  // 显示子窗口_
          windowClass.showWindow();
        });
      });
    }
    
    效果如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/4BujIfnHSZykFSw7_M4nDw/zh-cn_image_0000002658849125.png?HW-CC-KV=V1&HW-CC-Date=20260709T134007Z&HW-CC-Expire=86400&HW-CC-Sign=EC24B387F3BB8D740395FB65FCF5F2CAC54AD380BAEA4FA40559376515B8720A "点击放大")
    
*   推荐使用openCustomDialog弹出框替代。并使用模态窗覆盖旧页面，遮挡住创建弹窗的组件，防止多次点击，部分代码实现如下。
    
    _// CustomDialog弹窗的builder函数_
    @Builder
    customDialogComponent() {
      Scroll() {
        Column() {
          Row({ space: 50 }) {
            Text('这是一个弹窗')
          }.height(200).padding(5)
        }
      }
    }
    
    _// 打开弹窗_
    openDialog() {
      this.getUIContext().getPromptAction().openCustomDialog({
      _  // 弹出框的内容_
        builder: () => {
          _// @builder装饰器所装饰的函数_
          this.customDialogComponent();
        },
       _ // 使用模态窗_
        isModal: true,
      _  // 蒙层颜色_
        maskColor: '#33000000',
      });
    }
    
    效果如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/72/v3/671kwHT_SwiRkcmeeZ5Qjw/zh-cn_image_0000002628609862.png?HW-CC-KV=V1&HW-CC-Date=20260709T134007Z&HW-CC-Expire=86400&HW-CC-Sign=678D512C101C3E8CEA35B5F1A17395FEBB487B5E0516751432A4B37EB99D9231 "点击放大")
    

完整代码如下：

import { display, window } from '@kit.ArkUI';


@Entry
@Component
struct DialogTest {
  _// 需要提前在EntryAbility的onWindowStageCreate声明周期中使用AppStorage保存windowStage实例_
  _// 在这里取出存储的windowStage实例_
  @StorageLink('windowStage') windowStage: window.WindowStage | undefined = AppStorage.get('windowStage');


  /_/ 创建弹窗的方法，subWindow方案_
  _// 此处仅为示例，实际现象是仅平板横屏时弹窗未遮挡按钮_
  createWindow() {
  _  // 获取屏幕数据_
    const screen = display.getDefaultDisplaySync();
 _   // 创建子窗，传入固定的子窗名字_
    this.windowStage?.createSubWindow(\`subWindowDialog\`).then((windowClass: window.Window) => {
    _  // 子窗加载页面_
      _// 此处仅为示例，需要更换为实际页面，并通过LocalStorage传入状态属性_
      windowClass.loadContent('pages/DialogTest', new LocalStorage(), () => {
     _   // 设置子窗口的宽高，高度是屏幕高度的一半再减去导航条区域的高度_
        windowClass.resize(screen.width / 2, screen.height / 2 - this.getUIContext().vp2px(40));
      _  // 设置子窗口的背景色_
        windowClass.setWindowBackgroundColor('#ffffffff');
       _ // 移动子窗口的位置_
        windowClass.moveWindowToAsync(screen.width / 4, screen.height / 2);
       _ // 显示子窗口_
        windowClass.showWindow();
      });
    });
  }




 _ // CustomDialog弹窗的builder函数_
  @Builder
  customDialogComponent() {
    Scroll() {
      Column() {
        Row({ space: 50 }) {
          Text('这是一个弹窗')
        }.height(200).padding(5)
      }
    }
  }


 _ // 打开弹窗_
  openDialog() {
    this.getUIContext().getPromptAction().openCustomDialog({
    _  // 弹出框的内容_
      builder: () => {
     _   // @builder装饰器所装饰的函数_
        this.customDialogComponent();
      },
    _  // 使用模态窗_
      isModal: true,
     _ // 蒙层颜色_
      maskColor: '#33000000',
    });
  }


  build() {
    Column({ space: 20 }) {
      Button('弹出弹框-CustomDialog')
        .margin({ top: 40 })
        .onClick(() => {
          this.openDialog();
        });
      Button('弹出弹框-SubWindow')
        .onClick(() => {
          this.createWindow();
        })
      Button('关闭弹窗-SubWindow')
        .onClick(() => {
          window.getLastWindow(this.getUIContext().getHostContext()).then((windowClass) => {
            windowClass.destroyWindow();
          });
        })
    }
    .width('100%')
    .height('100%')
  }
}