HarmonyOS 应用开发之@Require装饰器：校验构造传参

最新推荐文章于 2025-06-13 13:54:46 发布

原创

最新推荐文章于 2025-06-13 13:54:46 发布 · 1.3k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #java #深度学习 #开发语言 #数据库 #物联网 #华为

@Require是校验@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)是否需要构造传参的一个装饰器。

说明：
从API version 11开始对@Prop/@BuilderParam进行校验。

从API version 12开始对@State/@Provide/普通变量(无状态装饰器修饰的变量)进行校验。

概述

当@Require装饰器和@Prop、@State、@Provide、@BuilderParam、普通变量(无状态装饰器修饰的变量)结合使用时，在构造该自定义组件时，@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)必须在构造时传参。

限制条件

@Require装饰器仅用于装饰struct内的@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)。

使用场景

当Child组件内使用@Require装饰器和@Prop、@State、@Provide、@BuilderParam和普通变量(无状态装饰器修饰的变量)结合使用时，父组件Index在构造Child时必须传参，否则编译不通过。

@Entry
@Component
struct Index {
   
   
  @State message: string = 'Hello World';

  @Builder buildTest() {
   
   
    Row() {
   
   
      Text('Hello, world')
        .fontSize(30)
    }
  }

  build() {
   
   
    Row() {
   
   
      Child({
   
    regular_value: this.message, state_value: this.message, provide_value: this.message, initMessage: this.message, message: this.message,
        buildTest: this.buildTest, initbuildTest: this.buildTest })