#跟着坚果学鸿蒙#

其他状态管理概述

除了前面章节提到的组件状态管理和应用状态管理,ArkTS还提供了@Watch$$来为开发者提供更多功能:

  @Watch用于监听状态变量的变化。

  $$运算符:给内置组件提供TS变量的引用,使得TS变量和内置组件的内部状态保持同步。

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

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

概述

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

装饰器说明

语法说明

观察变化和行为表现

  当观察到状态变量的变化(包括双向绑定的AppStorageLocalStorage中对应的key发生的变化)的时候,对应的@Watch的回调方法将被触发;

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

  如果在@Watch的方法里改变了其他的状态变量,也会引起的状态变更和@Watch的执行;

  在第一次初始化的时候,@Watch装饰的方法不会被调用,即认为初始化不是状态变量的改变。只有在后续状态改变时,才会调用@Watch回调方法。

限制条件

   建议开发者避免无限循环。循环可能是因为在@Watch的回调方法里直接或者间接地修改了同一个状态变量引起的。为了避免循环的产生,建议不要在@Watch的回调方法里修改当前装饰的状态变量;

  开发者应关注性能,属性值更新函数会延迟组件的重新渲染(具体请见上面的行为表现),因此,回调函数应仅执行快速运算;

  不建议在@Watch函数中调用async await,因为@Watch设计的用途是为了快速的计算,异步行为可能会导致重新渲染速度的性能问题。

使用场景

@Watch和自定义组件更新

以下示例展示组件更新和@Watch的处理步骤。countCountModifier中由@State装饰,在TotalView中由@Prop装饰。

@Component
struct TotalView {
@Prop @Watch('onCountUpdated') count: number; @State total: number = 0;
// @Watch cb
onCountUpdated(propName: string): void { this.total += this.count;
}

build() {
Text(`Total: ${this.total}`)
}
}

@Entry @Component
struct CountModifier { @State count: number = 0;

build() {
Column() {
.onClick(() => { this.count++
})
TotalView({ count: this.count })
}
}
}

处理步骤:

CountModifier自定义组件的Button.onClick点击事件自增count

由于@State count变量更改,子组件TotalView中的@Prop被更新,其@Watch('onCountUpdated')法被调用,更新了子组件TotalView 中的total变量。

子组件TotalView中的Text重新渲染。

@Watch@Link组合使用

以下示例说明了如何在子组件中观察@Link变量。

class PurchaseItem {
static NextId: number = 0; public id: number;
public price: number;

constructor(price: number) { this.id = PurchaseItem.NextId++; this.price = price;
}
}

@Component
struct BasketViewer {
@Link @Watch('onBasketUpdated') shopBasket: PurchaseItem[]; @State totalPurchase: number = 0;

updateTotal(): number {
let total = this.shopBasket.reduce((sum, i) => sum + i.price, 0);
// 超过100欧元可享受折扣
if (total >= 100) { total = 0.9 * total;
}
return total;
}
// @Watch 回调
onBasketUpdated(propName: string): void { this.totalPurchase = this.updateTotal();
}

build() {
Column() { ForEach(this.shopBasket,
(item) => {
Text(`Price: ${item.price.toFixed(2)} €`)
)
Text(`Total: ${this.totalPurchase.toFixed(2)} €`)
}
}
}

@Entry @Component
struct BasketModifier {
@State shopBasket: PurchaseItem[] = [];

build() {
Column() {
Button('Add to basket')
.onClick(() => {
this.shopBasket.push(new PurchaseItem(Math.round(100 * Math.random())))
})
BasketViewer({ shopBasket: $shopBasket })
}
}
}

处理步骤如下:

 BasketModifier组件的Button.onClickBasketModifier shopBasket中添加条目;  @Link装饰的BasketViewer shopBasket值发生变化;

 状态管理框架调用@Watch函数BasketViewer onBasketUpdated 更新BasketViewer TotalPurchase的值;

  @Link shopBasket的改变,新增了数组项,ForEach组件会执行item Builder,渲染构建新的Item

项;@State  totalPurchase改变,对应的Text组件也重新渲染;重新渲染是异步发生的。

$$语法:内置组件双向同步

$$运算符为系统内置组件提供TS变量的引用,使得TS变量和系统内置组件的内部状态保持同步。内部状态具体指什么取决于组件。例如,bindPopup属性方法的show参数。

使用规则

 当前$$支持基础类型变量,以及@State@Link@Prop装饰的变量。   当前$$仅支持bindPopup属性方法的show参数,Radio

组件的checked属性,Refresh组件的refreshing参数。

  $$绑定的变量变化时,会触发UI的同步刷新。

使用示例

bindPopup属性方法的show参数为例:

// xxx.ets @Entry @Component
struct bindPopupPage {
@State customPopup: boolean = false;

build() {
Column() { Button('Popup')
.margin(20)
.onClick(() => {
this.customPopup = !this.customPopup
})
.bindPopup($$this.customPopup, { message: 'showPopup'
})
}
}

 

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐