1# \@ComponentV2装饰器：自定义组件
2
3为了在自定义组件中使用V2版本状态变量装饰器的能力，开发者可以使用\@ComponentV2装饰器装饰自定义组件。
4
5>**说明：**
6>
7>\@ComponentV2装饰器从API version 12开始支持。
8>
9>当前状态管理（V2试用版）仍在逐步开发中，相关功能尚未成熟，建议开发者尝鲜试用。
10
11
12## 概述
13
14和[\@Component装饰器](arkts-create-custom-components.md)一样，\@ComponentV2装饰器用于装饰自定义组件：
15
16- 在\@ComponentV2装饰的自定义组件中，开发者仅可以使用全新的状态变量装饰器，包括\@Local、\@Param、\@Once、\@Event、\@Provider、\@Consumer等。
17- \@ComponentV2装饰的自定义组件暂不支持组件复用、LocalStorage等现有自定义组件的能力。
18- 无法同时使用\@ComponentV2与\@Component装饰同一个struct结构。
19- \@ComponentV2支持一个可选的boolean类型参数freezeWhenInactive，来实现[组件冻结功能](arkts-custom-components-freezeV2.md)。
20
21- 一个简单的\@ComponentV2装饰的自定义组件应具有以下部分：
22
23    ```ts
24    @ComponentV2 // 装饰器
25    struct Index { // struct声明的数据结构
26      build() { // build定义的UI
27      }
28    }
29    ```
30
31除非特别说明，\@ComponentV2装饰的自定义组件将与\@Component装饰的自定义组件保持相同的行为。
32
33## 限制条件
34
35在将\@Component装饰的自定义组件与\@ComponentV2装饰的自定义组件混合使用时，以下情况的变量传递是不允许的：
36
37- \@ComponentV2装饰的自定义组件中的非状态变量接收来自父组件传递的变量。
38
39- 将\@State、\@Prop、\@Link、\@ObjectLink、\@Provide、\@Consume、\@StorageLink、\@StorageProp、\@LocalStorageLink、\@LocalStorageProp等装饰的对象类型的变量传递给\@ComponentV2装饰的自定义组件里的\@Param、\@Event等装饰的变量。
40
41- 将被\@Local、\@Param、\@Event、\@Provider、\@Consumer等装饰的Array、Set、Map、Date类型的变量传递给\@Component装饰的自定义组件里的@State、\@Prop、\@ObjectLink、\@Provide等装饰的变量。
42
43- 在\@Component装饰的自定义组件里被@Link修饰的变量，接收来自\@ComponentV2装饰的父组件传递的变量。
44
45- 在\@Component装饰的自定义组件中使用\@State、\@Prop、\@Link、\@Provide、\@Consume、\@StorageLink、\@StorageProp、\@LocalStorageLink、\@LocalStorageProp装饰被\@ObservedV2装饰的类。
46
47- 在\@ComponentV2装饰的自定义组件中使用\@Local、\@Param、\@Event、\@Provider()、\@Consumer()装饰被\@Observed装饰的类。