HarmonyOS 组件隔代双向数据通信Provide与Consume

news2025/2/27 13:58:26

今天我们说一个场景

我们可以编写代码如下

@Entry
@Component
struct Index {

  @State name:string = "小猫猫";

  build() {
    Row() {
      Column() {
        Text(this.name)
        Button("改个name").onClick(() => {
          this.name = this.name == "小猫猫"?"小狗狗":"小猫猫";
        })
        son()
      }
      .width('100%')
    }
    .height('100%')
  }
}

@Component
struct son {
  build() {
    Row() {
      Column() {
        Text("子组件")
        grandson()
      }
    }
  }
}

@Component
struct grandson {
  build() {
    Row() {
      Column() {
        Text("底层组件")
      }
    }
  }
}

简单捋一下我们index组件上挂了@Entry修饰器说明第一次进入page 默认访问 index组件
然后他定义了一个name 用@State修饰说明这是个响应式数据
然后 index 调用了 son 组件
son 又调用了 grandson 组件
运行结果如下
在这里插入图片描述
那么如果我们想将index 组件内的name 传给 grandson 呢？

之前我们说的 @Link 其实你一层一层传下来是可以的但是如果中间隔离十几二十个组件呢？
一层一层传下来就显得有点捞了

这里我们就要带出一对新的修饰器 @Provide 和 @Consume

我们可以这样写

@Entry
@Component
struct Index {

  @Provide name:string = "小猫猫";

  build() {
    Row() {
      Column() {
        Text(this.name)
        Button("改个name").onClick(() => {
          this.name = this.name == "小猫猫"?"小狗狗":"小猫猫";
        })
        son()
      }
      .width('100%')
    }
    .height('100%')
  }
}

@Component
struct son {
  build() {
    Row() {
      Column() {
        Text("子组件")
        grandson()
      }
    }
  }
}

@Component
struct grandson {
  @Consume name:string

  build() {
    Row() {
      Column() {
        Text(this.name)
        Button("改个name").onClick(() => {
          this.name = "小海豚";
        })
      }
    }
  }
}

我们用 Provide 声明name 表示将变量提供给后代组件
然后我们在 grandson 组件中去取通过@Consume 这里注意需要同名然后类型相同即可
运行结果如下
在这里插入图片描述
且无论是在哪一个组件修改这个值都是可以互相响应的

这个数据传递还是个双向的非常的好用

如果说你不想同名我们可以这样

@Entry
@Component
struct Index {

  @Provide("name") name:string = "小猫猫";

  build() {
    Row() {
      Column() {
        Text(this.name)
        Button("改个name").onClick(() => {
          this.name = this.name == "小猫猫"?"小狗狗":"小猫猫";
        })
        son()
      }
      .width('100%')
    }
    .height('100%')
  }
}

@Component
struct son {
  build() {
    Row() {
      Column() {
        Text("子组件")
        grandson()
      }
    }
  }
}

@Component
struct grandson {
  @Consume("name") userName:string

  build() {
    Row() {
      Column() {
        Text(this.userName)
        Button("改个name").onClick(() => {
          this.userName = "小海豚";
        })
      }
    }
  }
}