输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
  • 更多
高级筛选
API version全部版本
设备全部
元服务API集不筛选

@ComponentV2：自定义组件V2

Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-09-09 06:54
本文导读

@ComponentV2主要配合状态管理V2使用，相比@Component，@ComponentV2支持对象的深度观测和深度监听，装饰器易用性高、拓展性强，适用于需要深度观测嵌套对象状态的场景。除非特别说明，@ComponentV2装饰的自定义组件将与@Component装饰的自定义组件保持相同的行为。

开发指南参考：@ComponentV2。

说明

  • 本装饰器首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

  • 从API版本26.0.0开始，@ComponentV2的ComponentOptions参数支持可选属性reusePool和poolAccepts，用于配置全局复用池，开发指南参考：全局复用：集中化的组件回收与复用。

@ComponentV2

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

const ComponentV2: ClassDecorator & ((options: ComponentOptions) => ClassDecorator)

卡片能力： 从API version 12开始，该接口支持在ArkTS卡片中使用。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

展开
名称 类型 必填 说明
options ComponentOptions 否 @ComponentV2装饰器选项。当需要开启组件冻结或全局复用功能时传入此参数进行自定义配置；缺省时关闭组件冻结和全局复用功能。

返回值：

展开
类型 说明
ClassDecorator 类装饰器，开发者无需关注该返回值。

示例：

@Entry
@ComponentV2({ freezeWhenInactive: true }) // 开启组件冻结功能
struct MyComponent {
  build() {
    Column() {
      Text('Hello World!')
    }
  }
}
简体中文
搜索
请输入您想要搜索的关键词