文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

ArkUI

ArkTS

HarmonyOS 7

从API version 12开始引入的 @ComponentV2 及组件冻结功能,对自定义组件的状态管理和渲染性能带来了哪些实质性的改变?

从API version 12开始引入的 @ComponentV2 及组件冻结功能,对自定义组件的状态管理和渲染性能带来了哪些实质性的改变?

点赞
1
收藏
1
回复
22
分享
举报
浏览95 发布于4天前山西
全部评论
最多点赞
最新发布
最早发布

通过freezeWhenInactive属性设置使用冻结功能时,@ComponentV2装饰的自定义组件处于非激活状态,状态变量将不响应更新,即@Monitor不会调用,状态变量关联的节点不会刷新。

  • 最大好处:该冻结机制在复杂UI场景下能显著优化性能,避免非激活组件因状态变量更新进行无效刷新,从而减少资源消耗。
  • 冻结期间数据不丢失:被冻结组件的状态变量更新只是被延迟,组件重新激活时框架会执行必要刷新,UI 最终展示与最新状态一致,无需开发者手动同步。
  • V2 组件复用无需手动开启:@ReusableV2 组件进入复用池时自动冻结,回收期间不响应变化;而 V1 的 @Reusable 组件需要显式设置 freezeWhenInactive: true 才会在复用池中冻结。

与@Component自定义组件冻结不同,@ComponentV2装饰的自定义组件不支持在LazyForEach场景下缓存节点组件冻结。不建议滥用:该机制针对的是“多个不可见组件绑定了同一状态变量”的高负载场景;普通页面组件数量少时收益有限,且冻结会延迟不可见组件的刷新,若业务依赖不可见组件实时更新(如后台倒计时精确到毫秒级展示),需评估是否适用。

参考 @ComponentV2当前支持的场景

18楼编辑于昨天03:42 来自北京

核心变化可以概括为:@ComponentV2 重构了自定义组件的状态管理机制,组件冻结则进一步减少了非激活组件的无效 UI 刷新。 两者配合后,在多页面、Tab、多层级组件等复杂界面中,状态更新和渲染的控制更加精细。

主要有三个方面:

  1. 状态管理更加清晰。 V2 引入了新的状态装饰器体系,例如 @Local 管理组件内部状态,@Param 接收外部参数,@Event 处理事件,@Provider 和 @Consumer 实现跨层级状态共享。相比 V1 的 @State、@Prop、@Link 等机制,状态的归属和数据流向更加明确。
  2. 深层数据观察能力增强。 V2 支持通过 @ObservedV2 和 @Trace 观察对象及嵌套属性的变化,不再像 V1 那样经常需要通过 @ObjectLink 层层拆分对象。配合 @Monitor,还可以监听状态变化并获取变化前后的值,便于处理复杂业务状态。
  3. 组件冻结减少无效渲染。 API 12 起,V2 组件可以通过 freezeWhenInactive 开启冻结。例如:
收起
自动换行
深色代码主题
复制
@ComponentV2({ freezeWhenInactive: true })
struct DetailComponent {
  @Local count: number = 0;

  @Monitor('count')
  onCountChange() {
    console.info(`count: ${this.count}`);
  }

  build() {
    Text(`当前数量:${this.count}`)
  }
}

当组件处于非激活状态时,状态变量更新不会触发 @Monitor,关联 UI 节点也不会刷新;重新激活后,框架会处理必要的状态更新和界面刷新。适用场景包括页面路由、TabContent、Navigation,以及后续版本支持的 Repeat。

需要注意,组件冻结不等于暂停组件中的所有业务逻辑,它主要控制状态响应和 UI 更新,不会自动停止定时器、网络请求等任务。另外,freezeWhenInactive 默认不启用;V2 组件冻结也不支持 LazyForEach 缓存节点组件的冻结。

实际开发中,V2 更适合复杂嵌套状态和新业务组件;冻结功能则适合存在大量非激活页面或组件的场景。它们优化的是状态管理和 UI 刷新开销,并不意味着所有页面都能获得相同幅度的性能提升。

参考:华为开发者文档中的  ⁠@ComponentV2、 ⁠自定义组件冻结(V2)。 

展开全部
14楼回复于3天前 来自辽宁
从API version 12开始引入的@ComponentV2与组件冻结(freezeWhenInactive)功能,对自定义组件的状态管理和渲染性能带来了从“粗粒度标脏”到“属性级精准更新” 以及“按需刷新”的实质性改变。传统V1模型下,一个@State对象的任何字段变更都会标脏整个对象,导致所有消费该状态的组件全部重渲染,这在复杂嵌套场景下会造成大量多余渲染。而@ComponentV2配合@ObservedV2与@Trace实现了属性级依赖追踪:只有被@Trace标记的属性变更才会触发UI刷新,未被标记的属性完全不参与响应式,变更不会引起任何重渲染,这让渲染真正“跟着变的那个属性”走,而非跟着包含它的对象走,在嵌套组件场景下可带来显著的性能提升。与此同时,组件冻结机制通过freezeWhenInactive: true开启后,当组件处于非激活状态(如页面路由跳转后隐藏、TabContent非当前页、Navigation非当前栈、Repeat非可视区域等场景),其状态变量将不再响应更新,@Monitor不会被调用,关联节点也不会刷新,从而彻底避免非激活组件因状态变更进行无效刷新。需要注意的是,冻结功能默认不开启,需显式配置freezeWhenInactive;该能力从API 12开始支持@ComponentV2装饰的组件,API 18进一步支持自定义组件冻结的混用场景,API 22则支持通过BuilderNode的inheritFreezeOptions让中间层BuilderNode的子组件也能继承冻结能力。
13楼回复于3天前 来自湖北

你好,@ComponentV2 和组件冻结解决的是两个不同层面的问题:V2 负责把状态观测和更新做精准,冻结负责减少非激活组件的无效刷新。二者可以配合,但 @ComponentV2 并不等于自动开启冻结。

1. 状态管理:从“组件代理观测”转向“数据本身可观测”

V1 主要通过代理感知状态变化,嵌套对象通常需要配合 @Observed/@ObjectLink 逐层处理;V2 增强了数据观察能力,状态可以独立于 UI 存在,并支持:

  • 使用 @ObservedV2 + @Trace 精确观测嵌套对象属性,配合 @Monitor 还能监听深层路径并获取变化前后的值。
  • 支持对象属性级精准更新、数组元素最小化更新,减少无关 UI 的冗余刷新。
  • 使用 @Local 管理内部状态、`@Param` 声明输入、`@Event` 声明输出;`@Provider/@Consumer` 负责跨层级同步,组件的数据边界更加明确。
  • 使用 @Computed 缓存计算结果,避免同一派生值被多次使用时重复计算。

2. 渲染性能:精准更新 + 非激活组件延后刷新

显式配置:

收起
自动换行
深色代码主题
复制
@ComponentV2({ freezeWhenInactive: true })
struct Child {
  // ...
}

组件进入 inactive 状态后,状态变化不会触发其关联节点刷新,也不会触发对应的 @Monitor;恢复 active 后再进行相应刷新。因此在 Navigation 非栈顶页面、未选中的 TabContent、Repeat 缓存节点等场景,可以避免“用户看不到的组件也跟着刷新”的开销。

3. 使用时注意三个边界

  • freezeWhenInactive 默认不开启;V2 的精准观测也不等于整个应用自动获得冻结能力。
  • active/inactive 由框架支持的场景决定,不能简单理解为组件是否可见。
  • V2 不支持 LazyForEach 缓存节点的冻结,可使用 Repeat(API 18+);Navigation、TabContent 等混用场景从 API 18 起只解冻屏上节点。

因此,实质收益不是“少写几个装饰器”,而是:让真正变化的数据触发必要更新,让非激活组件暂时退出刷新链路。不过具体帧率、耗时提升仍取决于页面结构,建议通过 Profiler/Trace 对比验证。

官方文档与示例:

展开全部
9楼回复于3天前 来自湖南

@ComponentV2 让状态变化触发更精细的更新,组件冻结让非激活组件延后刷新。

  • 状态管理。@Local 管组件内部状态,@Param 接收外部输入,@Event 向外通知。复杂对象用 @ObservedV2 和 @Trace 显式标记需要观察的属性,支持深层观测。比如修改商品价格时,依赖价格的节点可以单独更新,减少无关节点刷新。 ArkUI 状态管理概述
  • 渲染性能。显式开启 freezeWhenInactive 后,在 Navigation、TabContent 等支持的场景中,组件处于非激活状态时会推迟关联节点刷新和组件内的 @Monitor 回调,重新激活后再按最新状态刷新。这样可以减少切页后旧页面反复刷新带来的开销。 V2 组件冻结

@ComponentV2 及其冻结能力从 API 12 开始支持,V1 的 @Component 冻结从 API 11 就已支持。 V1 组件冻结

2楼编辑于3天前 来自广东

从实际开发效果看,主要改进是:状态职责更清楚、嵌套数据能被精确观察,以及非激活组件可以暂停无效刷新。需要先区分版本:@Component 的组件冻结从 API 11 开始支持,API 12 新增的是 @ComponentV2 及其冻结能力。

1. 状态来源与数据流更加明确

@ComponentV2 配合 V2 状态装饰器使用:

  • @Local:组件内部状态,只能在本地初始化。
  • @Param:接收外部输入,并同步父组件传入值的变化。
  • @Event:子组件通过回调向外通知事件。
  • @Provider、@Consumer:实现跨组件层级的状态共享。
  • @Param @Once:只接收一次外部初始化,后续不再跟随父组件同步。

这样可以明确区分“组件自己维护的数据”“父组件传入的数据”和“向外通知的事件”,降低复杂组件中的状态耦合。但迁移需要调整相应装饰器,不能只替换 @Component。

2. 数据本身可观察,嵌套属性更新更直接

V2 通过 @ObservedV2 与 @Trace,让数据模型中需要观察的属性具备响应能力,不必为观察深层属性而逐层拆分组件、传递 @ObjectLink。

例如,界面读取 model.user.name 时,如果对应的数据模型和属性已正确使用 V2 观察装饰器,修改深层的 name 就能通知依赖它的界面更新。

这里并不是所有普通对象都会自动变成深度响应式对象:@Local 本身不能观察普通类对象内部属性的变化,类属性的观察需要配合 @ObservedV2、@Trace。

3. 更新依赖更精确,减少冗余刷新

@Trace 将观察粒度落实到属性,状态变化时可以更新依赖该属性的 UI,减少无关属性关联节点的冗余更新。

同时,V2 的更新流程引入异步处理:当前事件逻辑执行完成后,再处理 @Computed、@Monitor 和节点标脏。因此,不能沿用“赋值后监听回调立即同步执行”的假设。

也不能简单说 V1 都是整组件刷新:V1 已有局部更新和 @Track 精确观察能力,V2 的改进还包括数据观察方式及更新流程。

4. 组件冻结减少非激活页面的无效工作

在需要冻结的 V2 自定义组件上配置:

@ComponentV2({ freezeWhenInactive: true })

默认不开启。以页面路由、TabContent、Navigation 场景为例,组件处于框架判定的非激活状态时:

  • 状态变化不会触发该冻结组件关联节点刷新。
  • 组件内相应的 @Monitor 回调暂停调用。
  • 恢复激活后,框架处理必要更新;官方页面路由示例中,会触发对应的 @Monitor 并更新文本。

例如,切走某个 Tab 后,共享数据仍不断变化,冻结可以避免隐藏 Tab 跟着反复刷新,从而减少 CPU 和渲染开销。

冻结不等于销毁组件,也不等于暂停定时器、网络请求或禁止数据修改。因此,必须持续执行的数据同步等业务逻辑,不宜依赖可能被冻结组件中的 @Monitor。

5. 使用时要考虑场景和版本边界

  • 冻结依赖框架支持的场景,不能将所有视觉上的“不可见”都等同于非激活。
  • 官方明确指出:V2 不支持 LazyForEach 场景下缓存节点的组件冻结。
  • 嵌套冻结存在版本差异:API 17 及以下,父组件恢复时会解冻全部子节点;API 18 起,只解冻相应的屏上节点。

因此,性能收益主要来自减少不必要的响应和刷新,具体提升幅度仍应结合页面结构、更新频率及 Profiler 数据验证。

展开全部
23楼回复于3小时前 来自浙江

@ComponentV2 是从 API version 12 开始引入的 V2 自定义组件装饰器,它与配套的组件冻结能力相配合,把状态管理从 V1 的“代理观察”范式升级为“数据本身可观察”范式,并在更新调度上引入异步标脏与按需刷新机制,对复杂 UI 场景下的刷新性能带来了实质性提升。需要说明的是,组件冻结机制本身在 @Component 组件上从 API version 11 就已支持,而 @ComponentV2 装饰器及其配套冻结能力从 API version 12 开始提供。

状态管理层面的实质性改变

1. 观察机制的根本转变

V1 状态管理使用代理观察数据:创建状态变量时会同时创建一个数据代理观察者,它只能感知代理变化而无法感知实际数据变化,因此存在四个固有限制——状态变量不能独立于 UI 存在(同一数据被多个视图代理时,其中一个视图的修改不会通知其他视图)、只能感知对象第一层属性变化、修改对象属性和数组元素时存在冗余更新、装饰器配合限制多且组件缺乏明确的输入输出契约。V2 将观察能力内置到数据本身,数据本身就是可观察的,更改数据即触发相应视图更新,状态可以独立于 UI 存在。

2. 属性级精准更新

@ObservedV2 与 @Trace 装饰器提供了对嵌套类对象属性变化的直接观测能力:@Trace 装饰的属性变化时,仅通知该属性关联的组件刷新,而非对象关联的全部组件,从机制上消除了 V1 修改嵌套属性时的冗余刷新;深度观测能力的引入也使嵌套类无需再借助 @ObjectLink 拆分子组件才能触发刷新。

3. 明确的组件输入输出契约

@ComponentV2 内仅可使用 V2 系列装饰器:@Param 声明外部输入(组件内不可直接修改,类对象接受数据源引用)、@Event 声明输出回调、@Local 声明内部状态(必须本地初始化),替代了 V1 的 @Prop/@Link 双向绑定体系,使组件的输入输出边界清晰,有利于组件化。@Monitor 替代 @Watch 提供对状态变量的异步监听;@Computed 提供带缓存的计算属性——依赖的状态变量变化时只求解一次,解决同一计算逻辑被 UI 多处绑定时的重复计算问题。

4. 异步标脏的更新机制

V1 修改状态变量后会立即标脏节点;V2 则在修改状态变量后抛出一个 Promise 微任务,待当前宏任务(如点击事件)执行完成后才处理组件标脏,@Computed、@Monitor 与节点标脏均异步执行。这一机制将状态更新与事件逻辑解耦,减少了同一事件内的无效重复刷新

渲染性能层面的实质性改变:组件冻结

工作机制:通过 ComponentOptions 的 freezeWhenInactive 属性开启(不传参数默认不开启)。开启后,系统仅对处于激活状态的自定义组件进行更新,UI 框架将更新范围缩小到用户可见的组件;非激活组件即使绑定的状态变量发生变化也不刷新,@Monitor 回调不会被调用;当组件重新变为激活状态时,状态管理框架会执行必要的刷新操作,确保 UI 正确展示。

适用场景:页面路由(非栈顶页面冻结)、TabContent(非当前页签冻结)、Navigation(未显示的 NavDestination 冻结)、Repeat。注意与 V1 的差异:@ComponentV2 装饰的组件不支持在 LazyForEach 场景下对缓存节点组件的冻结。

组件复用场景的自动冻结:V1 复用组件在复用池中仍会响应更新,需要开发者手动开启 freezeWhenInactive 才能冻结;而 V2 组件进入复用池时会被自动冻结,不响应回收期间发生的数据变化,从复用池上树后再恢复刷新,无需额外配置

比如:

收起
自动换行
深色代码主题
复制
// 数据层:@ObservedV2 + @Trace 使数据本身可观察,支持属性级精准刷新
@ObservedV2
class UserInfo {
  @Trace name: string = '开发者';
  @Trace loginCount: number = 0;
}

// 子组件:通过 ComponentOptions 开启组件冻结
@ComponentV2({ freezeWhenInactive: true })
struct ProfileCard {
  // @Param:外部输入,组件内不可直接修改;类对象接受数据源引用
  @Param user: UserInfo = new UserInfo();
  // @Event:显式声明输出回调,替代 V1 的 @Link 双向绑定
  @Event onNameChange: (newName: string) => void = (newName: string): void => {};
  // @Local:组件内部状态,必须本地初始化
  @Local editCount: number = 0;

  // @Computed:带缓存的计算属性,依赖变化时只计算一次
  @Computed
  get level(): string {
    return this.user.loginCount > 10 ? '高级用户' : '普通用户';
  }

  // @Monitor:异步监听状态变化,替代 V1 的 @Watch
  // 组件处于非激活状态时,该回调不会被调用
  @Monitor('user.name')
  onNameChanged(mon: IMonitor): void {
    this.editCount++;
  }

  build() {
    Column({ space: 8 }) {
      Text(this.user.name).fontSize(18)
      Text(`等级:${this.level}`).fontSize(14)
      Text(`编辑次数:${this.editCount}`).fontSize(14)
      Button('修改昵称')
        .onClick(() => {
          // 通过 @Event 通知父组件修改数据源,而非直接修改 @Param
          this.onNameChange('HarmonyOS');
        })
    }
    .padding(12)
  }
}

@Entry
@ComponentV2
struct Index {
  // 普通成员变量持有 @ObservedV2 实例:状态可独立于装饰器存在
  user: UserInfo = new UserInfo();

  build() {
    Column({ space: 12 }) {
      ProfileCard({
        user: this.user,
        onNameChange: (newName: string): void => {
          // @Trace 属性变化:仅刷新绑定了该属性的节点
          this.user.name = newName;
          this.user.loginCount++;
        }
      })
      // 父组件直接感知 @Trace 属性变化,无需代理透传
      Text(`登录次数:${this.user.loginCount}`).fontSize(14)
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

状态管理概述-指南与API参考-指南-应用框架-ArkUI(方舟UI框架)-UI开发 (ArkTS声明式开发范式)-学习UI范式状态管理-状态管理概述 - 华为HarmonyOS开发者

展开全部
22楼回复于4小时前 来自湖北

背景知识:

@ComponentV2 与组件冻结从 API version 12 开始引入,二者配合将自定义组件的状态管理从"组件级粗粒度观测"升级为"属性级精确观测 + 按需刷新",核心改变体现在状态观测粒度、数据流向显式化、以及不可见组件的刷新抑制三个方面。

一、状态管理能力的实质性改变

  1. 观测粒度细化到类属性级别。V1 中深度观测嵌套对象需要 @Observed + @ObjectLink + @Track 组合,且子组件必须包装一层;V2 使用 @ObservedV2 + @Trace 装饰类及类中属性,即可对嵌套类、继承类中的属性变化直接观测,且被 @Trace 装饰的属性变化时,仅会通知该属性关联的组件刷新,未被 @Trace 装饰的属性变化无法触发 UI 刷新。这避免了 V1 中整个对象关联组件被连带刷新的开销。
  2. 数据流向显式化。@ComponentV2 内只能使用 V2 装饰器(@Local、@Param、@Once、@Event、@Provider、@Consumer 等),且不能与 @Component 装饰同一个 struct。其中 @Local 表示组件内部状态,只允许本地初始化,不允许外部传参;@Param 表示外部传入状态,简单类型变量的双向同步需搭配 @Event 显式声明事件回调;@Once 则只在初始化时接受一次外部传入。相比 V1 中 @Link 的隐式双向绑定,V2 的"输入-输出"边界更清晰,状态来源可追溯。
  3. 监听能力增强。@Monitor 替代 @Watch,支持监听属性路径(如 counter.value),回调中可通过 IMonitor 获取变化的属性名及变化前后的值(before / now)。

二、渲染性能的实质性改变(组件冻结)

@ComponentV2 支持可选的 ComponentOptions 参数(freezeWhenInactive)来实现组件冻结3。其工作原理是:启用后系统仅对处于 active 状态的自定义组件进行更新,将刷新范围缩小到用户可见的组件;inactive 组件不响应状态变量变化,@Monitor/@Watch 回调不执行;当 inactive 组件重新变为 active 时,状态管理框架会对其执行必要的刷新,确保 UI 正确展示。

冻结机制目前覆盖五类场景:

场景 active 组件 inactive 组件
页面路由 当前栈顶页面 非栈顶不可见页面
TabContent 当前显示的页签 其余页签
LazyForEach 屏上节点 缓存节点
Navigation 当前 NavDestination 未显示的 NavDestination
组件复用 从复用池上树的节点 复用池中的节点

实际收益以长列表为例:50 条数据的 List 中触发全量状态变更时,开启冻结后仅刷新可视区域内的 15 个节点,LazyForEach 缓存节点和复用池节点既不刷新、也不触发 @Watch 回调。

此外,V2 组件在复用阶段会自动冻结,不响应回收期间发生的变化,而 V1 组件需要开发者手动开启 freezeWhenInactive 才能在复用池中不响应更新。

问题解决:

示例代码

以下示例综合演示属性级观测、显式数据流与组件冻结:非当前页签中的 TabPanel 处于 inactive 状态,tabState 变化不会触发其 @Monitor 回调,切回页签时才统一刷新。

收起
自动换行
深色代码主题
复制
// 属性级精确观测:仅 @Trace 装饰的属性变化才通知关联组件
@ObservedV2
class Counter {
  @Trace value: number = 0;
}

// 开启组件冻结:inactive 时不响应状态变化
@ComponentV2({ freezeWhenInactive: true })
struct TabPanel {
  // 外部传入,必须由父组件传参初始化
  @Require @Param panelName: string;
  // 显式事件回调:子组件通过事件通知父组件,替代 V1 的 @Link 双向绑定
  @Event onReport: (name: string, value: number) => void = () => {};
  // 内部状态:只允许本地初始化,不允许外部传参
  @Local counter: Counter = new Counter();

  // 监听属性路径,可获取变化前后的值
  @Monitor('counter.value')
  onValueChange(m: IMonitor) {
    console.info(`${this.panelName} value: ${m.value('counter.value')?.before} -> ${m.value('counter.value')?.now}`);
  }

  build() {
    Column({ space: 12 }) {
      Text(`${this.panelName}:${this.counter.value}`)
        .fontSize(24)
      Button('增加计数')
        .onClick(() => {
          this.counter.value++;
          this.onReport(this.panelName, this.counter.value);
        })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

@Entry
@ComponentV2
struct FreezeDemo {
  @Local tabState: number = 0;

  build() {
    Column() {
      Text(`共享状态:${this.tabState}`)
        .fontSize(20)
      Button('更新共享状态')
        .onClick(() => {
          this.tabState++;
        })
      Tabs() {
        TabContent() {
          TabPanel({ panelName: '页签A', onReport: (name: string, value: number) => {
            console.info(`report from ${name}: ${value}`);
          } })
        }.tabBar('页签A')
        TabContent() {
          TabPanel({ panelName: '页签B', onReport: (name: string, value: number) => {
            console.info(`report from ${name}: ${value}`);
          } })
        }.tabBar('页签B')
      }
      .width('100%')
      .height(300)
    }
    .width('100%')
    .height('100%')
  }
}

上述代码中,当前未选中的页签处于 inactive 状态,点击"更新共享状态"不会触发其内部刷新与 @Monitor 回调;切换到该页签时,组件转为 active,框架统一补齐刷新。

展开全部
21楼回复于昨天15:45 来自广东

@ComponentV2 把状态装饰器换成 @Local/@Param/@Event/@Computed/@Monitor,观察粒度细化到属性级,配合 @ObservedV2+@Trace 可直接深度观察嵌套对象,省去 V1 的 @Observed+@ObjectLink 双层绑定,只更新真正变化的节点,大对象与长列表场景的重渲染开销明显下降。

组件冻结需在组件上配置 freezeWhenInactive(true),处于 Navigation 非栈顶页、TabContent 非当前页等非激活态时,状态变量不再响应更新,@Monitor 不回调、关联节点不刷新,变更被缓存待重新激活后统一生效,避免无效刷新,降低 CPU 与功耗。注意 V1/V2 装饰器不可在同一 struct 混用。

20楼回复于昨天12:34 来自北京

对业务代码最明显的改变,是可以把“输入值”和“修改请求”拆开,让组件职责更清楚。例如 V2 的开关只接收当前值,通过事件请父组件修改:

收起
自动换行
深色代码主题
复制
@ComponentV2({ freezeWhenInactive: true })
struct MuteSwitch {
  @Param muted: boolean = false;
  @Event onMutedChange: (next: boolean) => void = () => {};
  build() {
    Toggle({ type: ToggleType.Switch, isOn: this.muted })
      .onChange((next: boolean) => this.onMutedChange(next))
  }
}

父组件用自己的 @Local 状态初始化 muted,在 onMutedChange 中回写;类对象内部还需要按字段配置 @ObservedV2/@Trace,不是普通 JSON 自动深度响应。

冻结解决的是非激活组件的无效刷新。建议做一次明确的验证:页面隐藏后连续改状态,再返回页面,看它是否呈现最新值,同时比较隐藏期 UI/Monitor 调用与恢复耗时。网络任务、定时器与每笔都不能丢的业务事件,应放在独立业务逻辑中,不能指望冻结替你暂停或排队。

V2 冻结从 API 12 支持,默认不开启;框架支持的 inactive 场景有范围,不能把任意 opacity=0 都当成已冻结。

参考: 官方说明 官方说明

19楼回复于昨天05:11 来自四川
共3页
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。