OpenHarmony 状态变量更改通知：@Watch 装饰器

@Watch 应用于对状态变量的监听。如果开发者需要关注某个状态变量的值是否改变，可以使用 @Watch 为状态变量设置回调函数。

说明：

从 API version 9 开始，该装饰器支持在 ArkTS 卡片中使用。

概述

@Watch 用于监听状态变量的变化，当状态变量变化时，@Watch 的回调方法将被调用。@Watch 在 ArkUI 框架内部判断数值有无更新使用的是严格相等（===），遵循严格相等规范。当在严格相等为 false 的情况下，就会触发 @Watch 的回调。

装饰器说明

@Watch补充变量装饰器	说明
装饰器参数	必填。常量字符串，字符串需要有引号。是(string) => void自定义成员函数的方法的引用。
可装饰的自定义组件变量	可监听所有装饰器装饰的状态变量。不允许监听常规变量。
装饰器的顺序	建议@State、@Prop、@Link等装饰器在@Watch装饰器之前。

语法说明

类型	说明
(changedPropertyName? : string) => void	该函数是自定义组件的成员函数，changedPropertyName是被watch的属性名。 在多个状态变量绑定同一个@Watch的回调方法的时候，可以通过changedPropertyName进行不同的逻辑处理 将属性名作为字符串输入参数，不返回任何内容。

观察变化和行为表现

1. 当观察到状态变量的变化（包括双向绑定的 AppStorage 和 LocalStorage 中对应的 key 发生的变化）的时候，对应的 @Watch 的回调方法将被触发；

2. @Watch 方法在自定义组件的属性变更之后同步执行；

3. 如果在 @Watch 的方法里改变了其他的状态变量，也会引起状态变更和 @Watch 的