@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装饰的自定义组件混合使用时，可参考混用文档。