如何实现基于dialogContent的自定义弹窗的双向数据绑定
================================

#### 问题现象

场景一：使用openCustomDialog打开的自定义弹窗中，如何实现弹窗和页面间的双向数据绑定？

场景二：使用bindSheet时，如何实现弹窗和页面间的双向数据绑定？

场景三：使用@CustomDialog时，如何实现弹窗和页面间的双向数据绑定？

#### 背景知识

*   [openCustomDialog](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-promptaction#opencustomdialog12)：创建并弹出dialogContent对应的自定义弹窗，该方法创建弹窗的方式有两种，一种是通过ComponentContent的方式创建弹窗，一种是通过builder的方式创建弹窗。
*   [update](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-arkui-componentcontent#update)：该接口属于ComponentContent自带的方法，用于更新通过ComponentContent创建的弹窗。
*   [bindSheet](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-sheet-transition#bindsheet)：给组件绑定半模态页面，点击后显示模态页面。
*   [@Builder装饰器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-builder#builder)：ArkUI提供轻量的UI元素复用机制@Builder，其内部UI结构固定，仅与使用方进行数据传递。开发者可将重复使用的UI元素抽象成方法，在build方法中调用。@Builder装饰的函数也称为“自定义构建函数”。
*   [自定义弹窗 (CustomDialog)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-custom-dialog-box#customdialogcontroller)：通过CustomDialogController类显示自定义弹窗。

#### 解决方案

*   场景一：使用openCustomDialog打开的自定义弹窗中，如何实现弹窗和页面间的双向数据绑定？
    
    *   方案一：使用[ComponentContent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-arkui-componentcontent)创建弹窗UI。
        
        实现弹窗和页面间的双向数据绑定的核心思路是通过共享同一个数据对象Params，并配合ComponentContent中的update()来主动刷新UI。
        
        在以下示例中，页面组件创建了一个Params的实例并传递给弹窗的UI内容childCom。
        
        1.  使用@ObservedV2观察Params的变化并使用@Trace装饰value使其能刷新UI。
            
            @ObservedV2
            class SceneOneOptionOneParams {
              @Trace value: string = '1';
              callback: () => void = (): void => {
              };
            }
            
        2.  页面数据同步到弹窗：更新dialogContent对应的自定义弹窗内容，需要使用update来进行修改。在Params参数类中可以定义一个空的callback函数，在页面组件的aboutToAppear方法中将update赋值给callback，当弹窗中数据进行更新时执行callback函数来更新WrappedBuilder对象封装的builder函数参数。
            
            aboutToAppear(): void {
              this.params.callback = () => {
                this.contentNode.update(this.params); _// 用于更新WrappedBuilder对象封装的builder函数参数_
              };
            }
            
            Button('修改value')
              .margin(10)
              .onClick(() => {
                this.params.value = this.params.value + '9';
                this.contentNode.update(this.params);
              });
            
        3.  弹窗数据同步到页面：弹窗中的TextInput组件通过onChange方法直接将输入值同步给params.value，而页面中的Text组件也通过params.value的值显示，因此实现了弹窗数据同步到页面。
            
            _// TextInput是弹窗中的组件_
            TextInput({
              text: params.value,
              placeholder: '你好'
            })
              .type(InputType.Normal)
              .height(40)
              .margin(10)
              .textAlign(TextAlign.Start)
              .onChange((value: string) => {
                params.value = value;
              });
            
            _// Text是页面中的组件_
            Text(\`text:${this.params.value}\`)
              .margin(10);
            
        
        完整示例代码如下：
        
        import { ComponentContent, UIContext } from '@kit.ArkUI';
        import { BusinessError } from '@kit.BasicServicesKit';
        
        @ObservedV2
        class SceneOneOptionOneParams {
          @Trace value: string = '1';
          callback: () => void = (): void => {
          };
        }
        
        @Builder
        function childComOne(params: SceneOneOptionOneParams) {
          Column() {
            Text(\`${params.value}\`);
        
            _// TextInput是弹窗中的组件_
            TextInput({
              text: params.value,
              placeholder: '你好'
            })
              .type(InputType.Normal)
              .height(40)
              .margin(10)
              .textAlign(TextAlign.Start)
              .onChange((value: string) => {
                params.value = value;
              });
        
            Blank()
              .height(10);
        
            Text('弹窗中修改value')
              .fontColor('#0a59f7')
              .onClick(() => {
                params.value = params.value + '0';
                params.callback();
              });
          }
          .borderRadius(16)
          .width('90%')
          .padding(20)
          .backgroundColor(Color.White);
        }
        
        export function showDialogOne<T extends object>(args: T, contentNode: ComponentContent<T>) {
          let uiContext = new UIContext();
          let promptActionUI = uiContext.getPromptAction();
          try {
            promptActionUI.openCustomDialog(contentNode, {
              isModal: true
            });
          } catch (error) {
            let message = (error as BusinessError).message;
            let code = (error as BusinessError).code;
            console.error(\`OpenCustomDialog args error code is ${code}, message is ${message}\`);
          };
        }
        
        @Entry
        @ComponentV2
        struct SceneOneOptionOne {
          params: SceneOneOptionOneParams = new SceneOneOptionOneParams();
          uiContext = this.getUIContext();
          contentNode = new ComponentContent(this.uiContext, wrapBuilder(childComOne), this.params);
        
          aboutToAppear(): void {
            this.params.callback = () => {
              this.contentNode.update(this.params); _// 用于更新WrappedBuilder对象封装的builder函数参数_
            };
          }
        
          build() {
            Column() {
              Column() {
                _// Text是页面中的组件_
                Text(\`text:${this.params.value}\`)
                  .margin(10);
        
                Button('修改value')
                  .margin(10)
                  .onClick(() => {
                    this.params.value = this.params.value + '9';
                    this.contentNode.update(this.params);
                  });
              }
              .padding(20)
              .margin(10);
        
              Button('打开弹窗')
                .margin(10)
                .onClick(() => {
                  showDialogOne<SceneOneOptionOneParams>(this.params, this.contentNode);
                });
            }
            .width('100%')
            .height('100%')
            .alignItems(HorizontalAlign.Center);
          }
        }
        
    *   方案二：直接使用builder创建弹窗UI。
        
        该方式下由于没有ComponentContent参与无需使用update()强制更新弹窗。完整示例代码如下：
        
        @ObservedV2
        class Params {
          @Trace value: string = '1';
        }
        
        @Entry
        @ComponentV2
        struct SceneOneOptionTwo {
          params: Params = new Params();
          uiContext = this.getUIContext();
        
          @Builder
          childCom(params: Params) {
            Column() {
              Text(\`${params.value}\`);
              _// TextInput是弹窗中的组件_
              TextInput({
                text: params.value,
                placeholder: '你好'
              })
                .type(InputType.Normal)
                .height(40)
                .margin(10)
                .textAlign(TextAlign.Start)
                .onChange((value: string) => {
                  params.value = value;
                });
              Blank()
                .height(10);
              Text('弹窗中修改value')
                .fontColor('#0a59f7')
                .onClick(() => {
                  params.value = params.value + '0';
                });
            }
            .borderRadius(16)
            .width('90%')
            .padding(20)
            .backgroundColor(Color.White);
          }
        
          build() {
            Column() {
              Column() {
                _// Text是页面中的组件_
                Text(\`text:${this.params.value}\`)
                  .margin(10);
                Button('修改value')
                  .margin(10)
                  .onClick(() => {
                    this.params.value = this.params.value + '1';
                  });
              }
              .padding(20)
              .margin(10);
        
              Button('打开弹窗')
                .margin(10)
                .onClick(() => {
                  this.uiContext.getPromptAction().openCustomDialog({
                    builder: () => {
                      this.childCom(this.params);
                    }
                  });
                });
            }
            .width('100%')
            .height('100%')
            .alignItems(HorizontalAlign.Center);
          }
        }
        
    
    场景一实现效果图如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fe/v3/5NxiSQbJRrOxRPQuY_Fauw/zh-cn_image_0000002628569612.png?HW-CC-KV=V1&HW-CC-Date=20260709T133934Z&HW-CC-Expire=86400&HW-CC-Sign=753574F464DF9FAA7318B4BA474F156FF4AD24F1002FB31BC7335AE514335963 "点击放大")
    
*   场景二：使用bindSheet时，如何实现弹窗和页面间的双向数据绑定？
    
    该场景下于场景一中的方案二基本一致，只需要注意builder的使用传递规则即可，完整示例代码如下：
    
    @Builder
    export function
    sheetBuilder(items: number\[\]) {
      Column() {
        _// 自定义滚动容器_
        List({ space: '10vp' }) {
          ForEach(items, (item: number) => {
            ListItem() {
              Text(String(item)).fontSize(16).fontWeight(FontWeight.Bold);
            }.width('90%').height('80vp').backgroundColor('#ff53ecd9').borderRadius(10);
          });
        }
        .alignListItem(ListItemAlign.Center)
        .margin({ top: '10vp' })
        .width('100%')
        .height('900px')
        _// 设置滚动组件的嵌套滚动属性_
        .nestedScroll({
          scrollForward: NestedScrollMode.PARENT\_FIRST,
          scrollBackward: NestedScrollMode.SELF\_FIRST,
        });
    
        Text('非滚动区域')
          .width('100%')
          .backgroundColor(Color.Gray)
          .layoutWeight(1)
          .textAlign(TextAlign.Center)
          .align(Alignment.Top);
      }.width('100%').height('100%');
    }
    
    @Entry
    @Component
    struct SceneTwo {
      _// 响应式状态变量：控制Sheet是否显示_
      @State isShowSheet: boolean = false;
      _// 定义菜单项数据参数_
      private items: number\[\] = \[0, 1, 2, 3, 4, 5, 6, 7, 8, 9\];
    
      build() {
        Column() {
          Button('Open Sheet').width('90%').height('80vp')
            .onClick(() => {
              this.isShowSheet = !this.isShowSheet;
            })
            _// 绑定Sheet组件：根据isShowSheet状态动态显示，传入参数items组数_
            .bindSheet($$this.isShowSheet, sheetBuilder(this.items), {
              _// Sheet尺寸配置：允许的展开尺寸_
              detents: \[SheetSize.MEDIUM, SheetSize.LARGE, 600\],
              _// 优先显示位置：底部弹出_
              preferType: SheetType.BOTTOM,
              _// 标题配置：设置Sheet标题_
              title: { title: '嵌套滚动场景' },
            });
        }.width('100%').height('100%')
        .justifyContent(FlexAlign.Center);
      }
    }
    
    场景二实现效果如下：
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/iibnXt-WRaKnlzMS2ywD_g/zh-cn_image_0000002628409712.png?HW-CC-KV=V1&HW-CC-Date=20260709T133934Z&HW-CC-Expire=86400&HW-CC-Sign=846E942033034FAA790CA1F00F7607777C787B068E6F1E80E614CE397FA35E90 "点击放大")
    
*   场景三：使用@CustomDialog时，如何实现弹窗和页面间的双向数据绑定？
    
    详情可参考官方文档：[示例6（使用@Link和@Consume监听数据变化）](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-methods-custom-dialog-box#示例6使用link和consume监听数据变化)。
    

#### 总结

一般创建弹窗UI的方式有以下三种，分别对应不同的同步弹窗与页面数据的方式：

| 
创建弹窗方式

 | 

解决方案

 |
| :-- | :-- |
| 

使用ComponentContent创建弹窗

 | 

该方式需要使用自带的update方法对弹窗进行更新。

 |
| 

使用builder创建弹窗

 | 

此时弹窗的同步与刷新需要符合builder的引用传递与回调传递。

 |
| 

使用@CustomDialog创建弹窗

 | 

可直接使用状态管理的[@Link](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-link)、[@Provide/@Consume](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-provide-and-consume)同步弹窗与页面数据。

 |