HarmonyOS NEXT开发笔记：@Computed装饰器计算属性

鸿蒙开发往期必看：

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

---

@Computed装饰器：计算属性，在被计算的值变化的时候，只会计算一次。主要应用于解决UI多次重用该属性从而重复计算导致的性能问题。

说明

@Computed装饰器从API version 12开始支持。

当前状态管理（V2试用版）仍在逐步开发中，相关功能尚未成熟，建议开发者尝鲜试用。

概述

@Computed为方法装饰器，装饰getter方法。@Computed会检测被计算的属性变化，当被计算的属性变化时，@Computed只会被求解一次。

对于复杂的计算，@Computed会有性能收益。

装饰器说明

@Computed语法：

@Computed get varName(): T {
    return value;
}

@Computed方法装饰器	说明
支持类型	getter访问器。
从父组件初始化	禁止。
可初始化子组件	@Param
被执行的时机	@ComponentV2被初始化时，计算属性会被触发被计算。当被计算的值改变的时候，计算属性也会发生计算。
是否允许赋值	@Computed装饰的属性是只读的，不允许赋值

使用限制

• @Computed为方法装饰器装饰getter方法，在getter方法中，不能改变参与计算的属性。

  @Computed
  get fullName() {
    this.lastName += 'a'; // error
    return this.firstName + ' ' + this.lastName;
  }

• @Computed不能和双向绑定!!连用，即@Computed装饰的是getter访问器，不会被子组件同步，也不能被赋值。开发者自己实现的计算属性的setter不生效。

  @ComponentV2
  struct Child {
    @Param double: number = 100
    @Event $double: (val: number) => void;
  
    build() {
      Button('ChildChange')
        .onClick(() => {
          this.$double(200)
        })
    }
  }
  
  @Entry
  @ComponentV2
  struct Index {
    @Local count: number = 100
  
    @Computed
    get double() {
      return this.count * 2
    }
  
    // @Computed装饰的属性是只读的，开发者自己实现的setter不生效
    set double(newValue : number) {
      this.count = newValue / 2;
    }
  
    build() {
      Scroll() {
        Column({ space: 3 }) {
          Text(`${this.count}`)
          // 错误写法，@Computed装饰的属性方法是只读的，无法和双向绑定连用
          Child({ double: this.double!! })
        }
      }
    }
  }

• @Computed为状态管理V2提供的能力，只能在@ComponentV2和@ObservedV2中使用。

• 多个@Computed一起使用时，警惕循环求解。

  @Local a : number = 1;
  @Computed
  get b() {
    return this.a + ' ' + this.c;  // error: b -> c -> b
  }
  @Computed
  get c() {
    return this.a + ' ' + this.b; // error: c -> b -> c
  }

使用场景

当被计算的属性变化时，@Computed装饰的getter访问器只会被求解一次

1. 在自定义组件中使用计算属性

• 点击第一个Button改变lastName，触发@Computed fullName重新计算。
• this.fullName被绑定在两个Text组件上，观察fullName日志，可以发现，计算只发生了一次。
• 对于前两个Text组件，this.lastName + ' '+ this.firstName这段逻辑被求解了两次。
• 如果UI中有多处需要使用this.lastName + ' '+ this.firstName这段计算逻辑，可以使用计算属性，减少计算次数。
• 点击第二个Button，age自增，UI无变化。因为age非状态变量，只有被观察到的变化才会触发@Computed fullName重新计算。

@Entry
@ComponentV2
struct Index {
  @Local firstName: string = 'Li';
  @Local lastName: string = 'Hua';
  age: number = 20; // cannot trigger Computed

  @Computed
  get fullName() {
    console.info("---------Computed----------");
    return this.firstName + ' ' + this.lastName + this.age;
  }

  build() {
    Column() {
      Text(this.lastName + ' ' + this.firstName)
      Text(this.lastName + ' ' + this.firstName)
      Divider()
      Text(this.fullName)
      Text(this.fullName)
      Button('changed lastName').onClick(() => {
        this.lastName += 'a';
      })

      Button('changed age').onClick(() => {
        this.age++;  // cannot trigger Computed
      })
    }
  }
}

但是需要注意，计算属性本身是有性能开销的，实际应用开发中：

• 如果是上面这种简单计算，可以不使用计算属性。
• 如果在视图中只使用一次，也可以不使用计算属性，建议直接求解。

1. 在@ObservedV2装饰的类中使用计算属性

• 点击Button改变lastName，触发@Computed fullName重新计算，且只被计算一次。

@ObservedV2
class Name {
  @Trace firstName: string = 'Li';
  @Trace lastName: string = 'Hua';

  @Computed
  get fullName() {
    console.info('---------Computed----------');
    return this.firstName + ' ' + this.lastName;
  }
}

const name: Name = new Name();

@Entry
@ComponentV2
struct Index {
  name1: Name = name;

  build() {
    Column() {
      Text(this.name1.fullName)
      Text(this.name1.fullName)
      Button('changed lastName').onClick(() => {
        this.name1.lastName += 'a';
      })
    }
  }
}

@Computed装饰的属性可以被@Monitor监听变化

下面的例子展示了使用计算属性求解fahrenheit和kelvin。

• 点击“-”，celsius-- -> fahrenheit -> kelvin --> kelvin改变触发onKelvinMonitor。
• 点击“+”，celsius++ -> fahrenheit -> kelvin --> kelvin改变触发onKelvinMonitor。

@Entry
@ComponentV2
struct MyView {
  @Local celsius: number = 20;

  @Computed
  get fahrenheit(): number {
    return this.celsius * 9 / 5 + 32; // C -> F
  }

  @Computed
  get kelvin(): number {
    return (this.fahrenheit - 32) * 5 / 9 + 273.15; // F -> K
  }

  @Monitor("kelvin")
  onKelvinMonitor(mon: IMonitor) {
    console.log("kelvin changed from " + mon.value()?.before + " to " + mon.value()?.now);
  }

  build() {
    Column({ space: 20 }) {
      Row({ space: 20 }) {
        Button('-')
          .onClick(() => {
            this.celsius--;
          })

        Text(`Celsius ${this.celsius.toFixed(1)}`).fontSize(50)

        Button('+')
          .onClick(() => {
            this.celsius++;
          })
      }

      Text(`Fahrenheit ${this.fahrenheit.toFixed(2)}`).fontSize(50)
      Text(`Kelvin ${this.kelvin.toFixed(2)}`).fontSize(50)
    }
    .width('100%')
  }
}

@Computed装饰的属性可以初始化@Param

下面的例子展示了@Computed初始@Param。

• 点击Button('-')和Button('+')改变商品数量，quantity是被@Trace装饰的，其改变时可以被观察到的。
• quantity的改变触发total和qualifiesForDiscount重新计算，计算商品总价和是否可以享有优惠。
• total和qualifiesForDiscount的改变触发子组件Child对应Text组件刷新。