鸿蒙：@objectLink和@obServed装饰器使用原理

原创已于 2024-07-01 10:59:21 修改 · 523 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#鸿蒙

于 2024-07-01 10:51:00 首次发布

两个装饰器用于涉及嵌套对象或数组元素为对象的场景中进行数据双向同步的（解决@state弊端）

@objectLink：用于嵌套对象修饰嵌套对象例：

@obServed：用于被嵌套对象，注意：修饰的变量不能为参数，需要定义函数进行封装将数据变成变量，才能使用@obServed修饰，可以是数组元素，可以是对象变量

总结：@objectLink和@obServed装饰器使用嵌套数据不能同步的场景

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

S妖O风F

关注关注

2
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

【鸿蒙HarmonyOS开发笔记】深入状态管理,详解@ObjectLink 和 @Observed装饰器

温的打怪之旅

03-18

2604

【鸿蒙HarmonyOS开发笔记】状态管理入门在之前的文章中我们简单了解了ArkTS提供了一系列状态相关的装饰器，例如@State@Prop@Link@Provide和@Consume等等。本文我们继续记录各种状态器所能观察到的变化范围@State对于classobject和数组类型，框架仅能观察到@State变量第一层属性的变化，例如persons[0]=new Person('张三',22)，但第二层属性的变化是观察不到的，例如和。@Prop。

鸿蒙页面级变量的状态管理【@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化】

2401_82772199的博客

07-30

1353

上文所述的装饰器仅能观察到第一层的变化，但是在实际应用开发中，应用会根据开发需要，封装自己的数据模型。对于多层嵌套的情况，比如二维数组，或者数组项class，或者class的属性是class，他们的第二层的属性变化是无法观察到的。这就引出了@Observed/@ObjectLink装饰器。

参与评论您还未登录，请先登录后发表或查看评论

鸿蒙 装饰器@Observed和@ObjectLink详解

最新发布

梦想不只是梦与想的博客

09-18

920

摘要：ArkUI框架中的@Observed和@ObjectLink装饰器组合用于实现嵌套对象属性变化的高效状态管理。@Observed作为类装饰器使自定义类可被观察，@ObjectLink建立属性级双向绑定，避免深拷贝性能损耗。两者配合支持基本类型、对象和集合属性变更，通过重写属性访问器实现变更检测。相比@Prop具有更好的性能和内存表现，适用于复杂表单、树形结构等场景。使用时需注意必须搭配使用、正确初始化和避免循环引用。该特性支持API9+的ArkTS卡片和API11+的元服务应用开发。

十一、【鸿蒙 NEXT】@Observed装饰器和@ObjectLink装饰器

zhujian82637的博客

03-21

868

我们经常会遇到这种场景，比如从后台获取到一个数组对象T[]，然后会根据该数组对象去循环渲染页面。当某个元素T中的某个属性值变更的时候，需要重新刷新页面。那么我们可以怎么操作去刷新页面呢？本节将讲下刷新页面的方法，以及它的优缺点。

鸿蒙HarmonyOS开发：@Observed装饰器和@ObjectLink装饰器：监听嵌套类对象属性变化

在这里，我乐于倾囊相授，分享我的技术心得、项目实战经验、技术技巧。希望能够惠及更多的开发者，助力大家在技术的海洋中扬帆远航。

08-05

2576

@State装饰器：组件内状态，@Prop装饰器：父子单向同步，@Link装饰器：父子双向同步，@Provide装饰器和@Consume装饰器：与后代组件双向同步。上文所述的装饰器仅能观察到第一层的变化，但是在实际应用开发中，应用会根据开发需要，封装自己的数据模型。对于多层嵌套的情况，比如二维数组，或者数组项class，或者class的属性是class，他们的第二层的属性变化是无法观察到的。这就引出了@Observed/@ObjectLink装饰器。

鸿蒙HarmonyOS嵌套类对象属性变化：@Observed 装饰器和 @ObjectLink 装饰器

小北的博客

09-11

1526

✍️作者简介：小北编程（专注于HarmonyOS、Android、Java、Web、TCP/IP等技术方向）🐳博客主页：🔥如需转载请参考在 HarmonyOS 的开发中，嵌套类对象属性的变化可以通过使用@Observed和装饰器来实现双向的数据绑定和状态同步。尤其当应用中存在多层嵌套的对象时，例如二维数组或对象的属性是其他对象时，HarmonyOS 的标准状态管理方法无法追踪这些嵌套对象的变化。因此，@Observed和装饰器的使用尤为关键。

HarmonyOS NEXT实战开发：@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

hanyanyou的博客

07-19

980

@ObjectLink和@Observed类装饰器用于在涉及嵌套对象或数组的场景中进行..........

HarmonyOS | 状态管理(五) | @Observed装饰器和@ObjectLink装饰器

让学习成为一种习惯 ( 谭祖爱 & 技术博客 )

02-27

2833

1. 被@Observed装饰的类，可被观察到属性变化； 2. 子组件中@ObjectLink装饰器装饰的状态变量用于接收@Observed装饰的类的实例，和父组件中对应的状态变量建立双向数据绑定。 3. 单独使用@Observed是没有任何作用的，需要搭配@ObjectLink或者@Prop使用。

【鸿蒙实战开发】@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

HarmonyOS_NEXT的博客

07-15

1337

为什么要有@Observed装饰器和@ObjectLink装饰器？在@Prop，@Link，@Provide与@Consume这几个装饰器仅能观察到第一层的变化，在实际应用开发中，应用会根据开发需要，封装自己的数据模型。对于多层嵌套的情况，比如二维数组，或者数组项class，或者class的属性是class，他们的第二层的属性变化是无法观察到的。这就引出了@Observed/@ObjectLink装饰器的作用。

OpenHarmony实战——@Observed装饰器和@ObjectLink装饰器

xianglizaibie的博客

03-24

784

ObjectLink和@Observed类装饰器用于在涉及嵌套对象或数组的场景中进行双向数据同步：● 被@Observed装饰的类，可以被观察到属性的变化；● 子组件中@ObjectLink装饰器装饰的状态变量用于接收@Observed装饰的类的实例，和父组件中对应的状态变量建立双向数据绑定。这个实例可以是数组中的被@Observed装饰的项，或者是class object中的属性，这个属性同样也需要被@Observed装饰。

鸿蒙开发之状态管理@Observed和@ObjectLink

Lu_Ca的博客

12-12

1582

当对象内引用对象，改变内部对象属性的时候其他状态管理如@State、@Provide、@Consume等是无法触发更新的。同样，在数组内如果有对象，改变对象的属性也是无法更新的。这个基础上，我们需要在点击任务完成的时候，修改任务列表卡片的文字颜色，并中划线。在我们需要监控的对象组件使用@Observed装饰，将需要变更的地方抽取出来作为一个新的组件，新组件内部引用对象使用@ObjectLink装饰。其中，需要注意的第一点，传递父组件的方法时，传递的是this.handleTaskNumber没有()。

鸿蒙开发笔记-Observed与ObjectLink

2301_79082288的博客

08-24

468

【代码】鸿蒙开发笔记-Observed与ObjectLink。

鸿蒙入门——ArkUI 自定义组件间的嵌套类对象属性双向同步@Observed和@ObjectLink装饰器小结（六）

最美不过，心中有梦，身旁有你！

12-02

1890

ObjectLink和@Observed类装饰器用于在涉及嵌套对象或数组的场景中进行双向数据同步。即@Observed 修饰的是被嵌套的对象和包含该嵌套对象的外层对象，@ObjectLink就是组件内修饰的被嵌套的对象。被@Observed装饰的类，可以被观察到属性的变化；子组件中@ObjectLink装饰器装饰的状态变量用于接收@Observed装饰的类的实例，和父组件中对应的状态变量建立双向数据绑定。

鸿蒙eTS状态管理Observed和ObjectLink

m0_61077450的博客

03-22

1089

eTS状态管理Observed和ObjectLink

鸿蒙中@observed与@ObjectLink的使用

qq_56203716的博客

09-21

247

他们两个必须搭配使用。

【HarmonyOS】多层嵌套对象通过@ObjectLink和@Observed实现渲染更新处理！

路漫漫亦无涯

06-02

1953

多层嵌套对象通过@ObjectLink和@Observed实现渲染更新处理

鸿蒙Harmony--状态管理器-@Observed装饰器和@ObjectLink装饰器详解

袁震的博客

01-11

2902

经历的越多，越喜欢简单的生活，干净的东西，清楚的感觉，有结果的事，和说到做到的人。把圈子变小，把语放缓，把心放宽，用心做好手边的事儿，该有的总会有的!

HarmonyOS--@ObjectLink和@Observed

weixin_56595425的博客

01-29

2213

构建智能任务列表：@ObjectLink 与 @Observed的魔法联动在HarmonyOS应用开发中，实现智能任务管理列表不再是繁琐的事情。本文将深入探讨@ObjectLink和@Observed这两个强大的注解，它们的巧妙联动为分布式环境下的任务数据同步提供了新的可能性。通过实例代码，你将领略到@ObjectLink如何在多设备之间实现数据共享，而@Observed又是如何在用户界面和业务逻辑之间搭建起一座自动同步的桥梁。不再需要繁杂的手动监听代码。

鸿蒙列表，item组件封装传参问题？@ObjectLink 和@Observerd

weixin_39971163的博客

12-25

913

ArtTS不支持这么做，也就是Link修饰的数据必须得是最外层的 State数据，想要实现我们刚刚的设想，我们还得另辟蹊径。-后续ObjectLink 和Observerd会解决这个问题。案例中：父组件的总和，是需要再传一个list数据进去，在子组件中使用@link 进行数据双向更新，才能实现ui试图更新的，因为鸿蒙数据只支持单层数据响应式更新。当然，如果只是对item内容进行纯ui渲染，可以不使用装饰器修饰，直接进行数据传递和接受渲染即可。鸿蒙列表渲染，封装内容组件，进行item传参会报错？

鸿蒙 next @Observed模型 @ObjectLink Ui 没有办法

08-19

在 HarmonyOS Next 开发中，使用 `@Observed` 模型和 `@ObjectLink` 时，若遇到 UI 无法正常更新或工作的情况，通常与状态管理和数据绑定机制的实现方式有关。以下是可能的原因和解决方案： ### 1. `@Observed` 模型未正确触发更新 `@Observed` 用于标记一个类作为可被观察的对象，当其属性发生变化时，依赖它的 UI 应该自动更新。如果 UI 没有更新，可能是因为： - **未使用 `@ObjectLink` 或 `@State` 等绑定装饰器**：在视图中引用 `@Observed` 对象的属性时，应使用 `@ObjectLink` 或 `@State` 来建立绑定关系。 - **未调用 `notifyPropertyChange` 方法**：对于 `@Observed` 类中的属性，必须显式调用 `notifyPropertyChange` 来通知框架属性已更改，否则框架不会触发 UI 更新。示例代码如下： ```typescript class MyModel { private _count: number = 0; get count(): number { return this._count; } set count(value: number) { this._count = value; notifyPropertyChange('count'); } } @Entry @Component struct MyComponent { @Observed private model: MyModel = new MyModel(); build() { Column() { Text(`Count: ${this.model.count}`) .fontSize(30) Button('Increment') { this.model.count += 1; } } .width('100%') .height('100%') } } ``` ### 2. `@ObjectLink` 绑定不正确 `@ObjectLink` 用于在组件之间共享 `@Observed` 对象的状态。如果未正确使用 `@ObjectLink`，可能会导致子组件无法接收到状态更新。确保： - 在子组件中使用 `@ObjectLink` 装饰器引用父组件传递的 `@Observed` 对象。 - 父组件通过 `@State` 或 `@Observed` 控制状态，并将其传递给子组件。示例代码如下： ```typescript @Component struct ChildComponent { @ObjectLink private model: MyModel; build() { Text(`Child Count: ${this.model.count}`) .fontSize(20) } } @Entry @Component struct ParentComponent { @State private model: MyModel = new MyModel(); build() { Column() { ChildComponent({ model: this.model }) Button('Increment') { this.model.count += 1; } } .width('100%') .height('100%') } } ``` ### 3. 数据流中断或未正确初始化在某些情况下，如果 `@Observed` 对象未正确初始化，或者在异步操作中未正确处理状态更新，也可能导致 UI 不更新。例如： - **异步操作未触发 UI 更新**：在异步回调中更新 `@Observed` 对象的属性时，需确保调用 `notifyPropertyChange` 或使用 `@State` 管理异步状态。 - **未正确处理复杂对象结构**：如果 `@Observed` 对象包含嵌套对象或数组，需确保每个层级的对象都正确实现了 `@Observed` 和 `notifyPropertyChange`。 ### 4. 检查视图组件是否正确绑定在某些情况下，视图组件可能未正确绑定到 `@Observed` 对象的属性，导致 UI 不更新。例如： - **直接访问对象属性而未使用绑定装饰器**：应确保在视图中使用 `@ObjectLink` 或 `@State` 来绑定对象属性。 - **未正确使用 `@Builder` 或 `@Component` 装饰器**：确保视图组件使用了正确的装饰器，并且组件结构正确。 ### 5. 调试建议 - **检查控制台日志**：查看是否有任何错误或警告信息，可能提示状态管理或绑定问题。 - **使用调试工具**：利用 HarmonyOS 提供的调试工具，检查状态更新是否正确触发，以及 UI 是否响应更新。 - **简化代码逻辑**：尝试简化代码逻辑，逐步排除可能的问题点，确保基本功能正常后再逐步恢复复杂性。