harmony 鸿蒙\@ComponentV2装饰器:自定义组件

2025-06-16 浏览 (1)

@ComponentV2装饰器:自定义组件

为了在自定义组件中使用V2版本状态变量装饰器的能力,开发者可以使用@ComponentV2装饰器装饰自定义组件。

@ComponentV2主要配合状态管理V2使用。阅读本文档前,建议提前阅读状态管理概述

说明:

@ComponentV2装饰器从API version 12开始支持。

概述

@Component装饰器一样,@ComponentV2装饰器用于装饰自定义组件:

  • 在@ComponentV2装饰的自定义组件中,开发者仅可以使用全新的状态变量装饰器,包括@Local、@Param、@Once、@Event、@Provider、@Consumer等。

  • @ComponentV2装饰的自定义组件暂不支持LocalStorage等现有自定义组件的能力。

  • 无法同时使用@ComponentV2与@Component装饰同一个struct结构。

  • @ComponentV2支持一个可选的boolean类型参数freezeWhenInactive,来实现组件冻结功能

  • 一个简单的@ComponentV2装饰的自定义组件应具有以下部分:

    @ComponentV2 // 装饰器
    struct Index { // struct声明的数据结构
      build() { // build定义的UI
      }
    }
    

除非特别说明,@ComponentV2装饰的自定义组件将与@Component装饰的自定义组件保持相同的行为。

限制条件

在将@Component装饰的自定义组件与@ComponentV2装饰的自定义组件混合使用时,可参考混用文档

你可能感兴趣的鸿蒙文章

harmony 鸿蒙@AnimatableExtend装饰器:定义可动画属性

harmony 鸿蒙管理应用拥有的状态概述

harmony 鸿蒙AppStorage:应用全局的UI状态存储

harmony 鸿蒙基本语法概述

harmony 鸿蒙@Builder装饰器:自定义构建函数

harmony 鸿蒙@BuilderParam装饰器:引用@Builder函数

harmony 鸿蒙创建自定义组件

harmony 鸿蒙自定义组件混用场景指导

harmony 鸿蒙自定义组件成员属性访问限定符使用限制

harmony 鸿蒙自定义组件冻结功能

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/FpXeN2