1# \@ComponentV2装饰器：自定义组件
2
3为了在自定义组件中使用V2版本状态变量装饰器的能力，开发者可以使用\@ComponentV2装饰器装饰自定义组件。
4
5
6\@ComponentV2主要配合状态管理V2使用。在阅读文档前，建议提前阅读：[状态管理概述](./arkts-state-management-overview.md)。
7
8>**说明：**
9>
10>\@ComponentV2装饰器从API version 12开始支持。
11>
12
13
14## 概述
15
16和[\@Component装饰器](arkts-create-custom-components.md)一样，\@ComponentV2装饰器用于装饰自定义组件：
17
18- 在\@ComponentV2装饰的自定义组件中，开发者仅可以使用全新的状态变量装饰器，包括\@Local、\@Param、\@Once、\@Event、\@Provider、\@Consumer等。
19- \@ComponentV2装饰的自定义组件暂不支持组件复用、LocalStorage等现有自定义组件的能力。
20- 无法同时使用\@ComponentV2与\@Component装饰同一个struct结构。
21- \@ComponentV2支持一个可选的boolean类型参数freezeWhenInactive，来实现[组件冻结功能](arkts-custom-components-freezeV2.md)。
22
23- 一个简单的\@ComponentV2装饰的自定义组件应具有以下部分：
24
25    ```ts
26    @ComponentV2 // 装饰器
27    struct Index { // struct声明的数据结构
28      build() { // build定义的UI
29      }
30    }
31    ```
32
33除非特别说明，\@ComponentV2装饰的自定义组件将与\@Component装饰的自定义组件保持相同的行为。
34
35## 限制条件
36
37在将\@Component装饰的自定义组件与\@ComponentV2装饰的自定义组件混合使用时，可参考[混用文档](./arkts-custom-component-mixed-scenarios.md)。
38