【HarmonyOS 5】鸿蒙中@State的原理详解

简介: @State 是 HarmonyOS ArkTS 框架中用于管理组件状态的核心装饰器,其核心作用是实现数据驱动 UI 的响应式编程模式。通过将变量标记为 @State,开发者可以确保当状态值发生变化时,依赖该状态的 UI 组件会自动重新渲染,从而保持数据与界面的实时同步。@State 是 HarmonyOS ArkTS 实现响应式编程的大基础核心,可以说整个V1和V2都是围绕它来进行组合使用。


##鸿蒙开发能力 ##HarmonyOS SDK应用服务##鸿蒙金融类应用 (金融理财#

一、@State在鸿蒙中是做什么的?

@State 是 HarmonyOS ArkTS 框架中用于管理组件状态的核心装饰器,其核心作用是实现数据驱动 UI 的响应式编程模式。通过将变量标记为 @State,开发者可以确保当状态值发生变化时,依赖该状态的 UI 组件会自动重新渲染,从而保持数据与界面的实时同步。

@State 是 HarmonyOS ArkTS 实现响应式编程的大基础核心,可以说整个V1和V2都是围绕它来进行组合使用。


二、@State的基本原理

@State 的响应式机制基于 依赖收集变更通知 两大核心流程,结合 TypeScript 装饰器和元编程技术实现。其核心原理是通过依赖收集和变更通知机制,确保状态变化自动同步到 UI。

1. 依赖关系的收集

当组件渲染时,ArkUI框架会追踪所有被 @State 修饰的变量在 UI组件 中的使用情况。
通过装饰器在变量的 getter 中注入依赖收集逻辑,记录当前组件对该状态的依赖关系。观察者的模式来进行数据变化的监控。
例如,当组件的Text中使用 this.message,框架会将该组件注册为 message 的依赖者。

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(() => {
          this.message = 'Welcome';
        })
    }
    .height('100%')
    .width('100%')
  }
}

2. 数据变更通知

@State 变量通过 this.message = xxxxxx 被修改时,框架会检测到值的变化。
使用 ProxyObject.defineProperty 拦截属性的赋值操作,触发变更通知。
框架遍历所有依赖该状态的组件,并调用其更新方法重新渲染 UI。
采用 脏检查优化异步渲染队列,合并多次更新操作,避免频繁重绘

响应式系统的核心流程

数据变化 → 依赖追踪 → 自动重渲染(60FPS 高帧率更新)



(1)数据变化:开发者通过 this.xxx = value 修改状态。
(2)依赖追踪:ArkUI框架根据之前收集的依赖关系,确定哪些组件需要更新。(哪个UI组件用了@State修饰的变量。)
(3)自动重渲染:仅重新渲染依赖该状态的组件,提升性能。(最小限度的刷新UI)

三、使用@State的注意事项

在使用 @State 时,需注意以下关键点以避免潜在问题:


1. 必须初始化
@State 变量必须在组件构造函数中初始化,否则会导致编译错误。

@Component
 struct MyComponent {
   @State count: number = 0; // 正确初始化
   // @State message: string; // 错误:未初始化
 }

2. 通过 this 赋值
必须通过 this.xxx = value 修改状态,直接赋值(如 xxx = value)不会触发 UI 更新。

onClick() {
   this.count = 1; // 正确,触发 UI 更新
   this.obj = { ...this.obj, key: 'new' }; // 正确,整体赋值
   this.obj.key = 'new'; // 错误,直接修改属性不触发更新
 }



3. 避免频繁更新
连续多次修改状态会导致多次重绘,可通过合并操作优化。



注意:

  1. 将独立变化的状态拆分为多个 @State 变量,避免不必要的组件刷新。
  2. 深层嵌套的对象或数组可能导致性能下降,建议使用扁平结构。
  3. 组件销毁时,@State 变量会自动释放,但需注意手动清理定时器等外部资源。
目录
相关文章
|
人工智能 自然语言处理 IDE
【HarmonyOS 5】鸿蒙CodeGenie AI辅助编程工具详解
1、CodeGenie是什么? CodeGenie (代码精灵)作为鸿蒙DevEco IDE自带的AI辅助编码工具。
967 0
|
C语言 C++
C/C++ 自定义头文件,及头文件结构详解
还是从"stdio.h"说起,这是C语言中内置的标准库,也就是说,头文件很多时候其实就是一个“库”,类似于代码的仓库,也就是说将某些具有特定功能的常量、宏、函数等归为一个大类,然后放进这个“仓库”,就像stdio.h就是一个标准输入/输出的头文件
686 1
|
存储 JavaScript 前端开发
Vue3 详细教程及实例(完整版)
Vue3 详细教程及实例(完整版)
1334 0
|
10月前
|
人工智能 运维 供应链
20个低代码开发平台多维度对比:解锁企业应用开发新动能
Gartner 报告指出,到 2024 年,低代码应用开发将占应用开发总数的 65%以上,将有 3/4 的大型企业会使用至少 4 个低代码平台进行 IT 应用开发。同时,市场研究机构的数据显示,在传统开发模式下,超过 70% 的企业项目存在开发周期延长的问题,平均延长时间达到原计划的 30%;约 80% 的企业表示在招募专业开发人才时面临困难;而面对个性化需求,近 90% 的企业认为传统开发响应速度慢,无法及时满足业务变化需求。这些数据充分表明,当前企业在应用开发上面临问题具有普遍性和严重性,低代码开发平台的兴起势在必行 ,其有望成为解决这些难题、推动企业数字化转型的关键力量。
1080 0
|
开发工具 开发者
【HarmonyOS 5】鸿蒙中的UIAbility详解(二)
singleton(单实例模式),说人话就是单例模式,App任务进度中该UIAbilty只能存在一个。 multiton(多实例模式),说人话就是单例模式,App任务进度中该UIAbilty能存在多个。 specified(指定实例模式),这玩意就有点复杂了,参见下图,主要通过唯一标识key来作为判断量,看该UIAbility是创建新的,还是使用已创建的。
491 0
|
开发工具
【HarmonyOS 5】Integrating WeChat Sharing into HarmonyOS Applications
【HarmonyOS 5】Integrating WeChat Sharing into HarmonyOS Applications
537 9
|
JavaScript 开发者 C++
HarmonyOS NEXT ArkUI生命周期终极指南 | 组件与页面的关系
本文是关于 HarmonyOS NEXT 中 ArkUI 生命周期的终极指南,深入解析组件与页面的关系及其生命周期特性。文章通过超全场景案例、隐藏技巧和避坑秘籍,帮助开发者轻松掌握生命周期管理。内容涵盖页面级(如 `onPageShow`、`onPageHide`)与组件级(如 `aboutToAppear`、`onDidBuild`)生命周期的区别与应用,并提供实战代码示例,包括基础版与高阶版用法。此外,还总结了十大避坑指南和神奇技巧,如实现页面停留统计与双击退出功能。掌握这些知识,助你精准控制 UI 更新,掌控组件与页面的生死轮回!
|
算法 PHP C++
priority_queue的使用与模拟实现
使用vector作为底层容器,内部构造大堆结构。使用vector作为底层容器,内部构造小堆结构。方式三:不指定底层容器和内部需要构造的堆结构。注意: 此时默认使用vector作为底层容器,内部默认构造大堆结构成员函数功能push()插入元素到队尾(并排序)pop()弹出队头元素(堆顶元素)top()访问队头元素(堆顶元素)size()获取队列中有效元素个数empty()判断队列是否为空swap()交换两个队列的内容int main()q.push(3);
222 0
|
编解码 弹性计算 前端开发
太详细了!终于有人把Netty原理架构讲解清楚了
本文基于 Netty 4.1 展开介绍相关理论模型,使用场景,基本组件、整体架构,知其然且知其所以然,希望给大家在实际开发实践、学习开源项目方面提供参考。
2097 1
太详细了!终于有人把Netty原理架构讲解清楚了
|
机器学习/深度学习 算法 计算机视觉
【Python篇】Python + OpenCV 全面实战:解锁图像处理与视觉智能的核心技能
【Python篇】Python + OpenCV 全面实战:解锁图像处理与视觉智能的核心技能
686 7