Harmony状态管理@Event

Harmony状态管理@Event

背景

在上一节中，我们针对父子组件，讲了关于传递数据的知识。我们了解到

1. @Local 是管理自己内部的数据的，
2. @Param 是负责接收父组件的数据的，而且子自己内部不能直接修改

按照一个组件最基本的功能，既能接收外部传入的数据 ，也要向外部传递数据 。那么 @Event 修饰符就是来解决这个问题的了。

介绍

@Event 是 子组件向父组件传递数据的技术，它只能用在 @ComponentV2 修改的组件上，其中的思想是

1. 完成修改数据的操作，还是放在父组件内部，通过定义一个函数 func 来实现
2. 在父组件调用子组件的时候，也顺带把这个函数 func 传递给子组件
3. 子组件在内部 使用 @Event 来修饰 该函数，并且在需要的使用直接调用即可

父组件

1. 定义内部数据 num

2. 定义修改内部数据num的函数 func

3. 使用子组件时，把num和func都传递过去

   @Entry
   @ComponentV2
   struct Index {
   @Local num: number = 100
   // 自己定义的函数 负责修改数据， 该函数也要传递给子组件
   func = (unit: number) => {
   this.num -= unit
   }

   build() {
   Column() {
   Button("父组件 修改" + this.num)
   .onClick(() => {
   this.num++
   })
   // 使用子组件，并且传递数据 和 传递函数
   Son({ num: this.num, func: this.func })
   .padding(10)
   }
   .width("100%")

   }
   }

子组件

1. 使用 @Param 接收父组件传递的 num

2. 使用@Event 接收父组件传递的函数 func

3. 定义点击事件的处理函数 onfunc，内部直接调用父组件传递过来的函数

   @ComponentV2
   struct Son {
   @Param num: number = 0
   @Event func: (num: number) => void = () => {
   }
   onfunc = () => {
   this.func(5)
   }

   build() {

    Column() {
      Button(`子组件 ${this.num}`)
   
      Button("子组件修改父组件中的状态")
        .onClick(this.onfunc)
    }
    .border({
      width: 1,
      style: BorderStyle.Dashed
    })

   }
   }

流程

@Once

@Once 和 @Param作用类似，都可以表示接收父组件传递过来的数据，但是也存在区别

1. @Once 只会接收第一次父组件传递过来的数据，后续父组件的数据修改，不会同步到 @Once修改的变量上

2. @Once 需要和 @Param 一起搭配使用，因为 @Param 修饰的是父组件传递给子组件的变量，该变量不能直接被修改。所以@Once修饰的变量，也不能在子组件内部直接修改。

   @ComponentV2
   struct Son {
   @Once @Param num: number = 0

   build() {
   Column() {
   Button(子组件 ${this.num})
   .onClick(() => {
   this.num++ // 修改无效
   })
   }
   .border({
   width: 1,
   style: BorderStyle.Dashed
   })
   }
   }

   @Entry
   @ComponentV2
   struct Index {
   @Local num: number = 100

   build() {
   Column() {

      Son({ num: this.num })
        .padding(10)
    }
    .width("100%")

   }
   }

总结

1. @Param 表示父组件传递给子组件的数据，当父组件修改了，子组件会跟随响应，同时子组件内部不能直接修改 @Param修饰的变量
2. @Event 表示子组件想要修改父组件数据的一种技术，它用来修改函数，该函数是由父组件定义和传递给子组件的
3. @Once 必须和 @Param 搭配使用，表示父组件传递过来的数据，只会第一次生效。