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

  • 2025-06-16
  • 浏览 (5)

\@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 鸿蒙自定义组件冻结功能

0  赞