| 状态名 | 同步 | 位置 | 初始值 | 变量类型 | 不支持的UL刷新 | 注意事项 |
|---|---|---|---|---|---|---|
| State | 父组件 | 必填 | Object、classstring、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 | 对象的对象数组属性更新数组对象的属性更新 | @ State装饰的变量必须初始化,否则编译期会报错。@State不支持装饰Function类型的变量,框架会抛出运行错误。 | |
| Prop | 单项 | 子组件 | 不必填 | Object、class、string、number、boolean、enum类型,以及这些类型的数组。不支持any,支持undefined和null。支持Date类型。 | Prop变量允许在本地修改,但修改后的变化不会同步回父组件。 | · @Prop装饰变量时会进行深拷贝,在拷贝的过程中除了基本类型、Map、Set、Date、Array外,都会丢失类型。例如[PixelMap](#状态名 同步 位置 初始值 变量类型 不支持的UL刷新 注意事项 State 父组件 必填 Object、classstring、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 对象的对象数组属性更新数组对象的属性更新 @ State装饰的变量必须初始化,否则编译期会报错。@State不支持装饰Function类型的变量,框架会抛出运行错误。 Prop 单项 子组件 不必填 Object、class、string、number、boolean、enum类型,以及这些类型的数组。不支持any,支持undefined和null。支持Date类型。 Prop变量允许在本地修改,但修改后的变化不会同步回父组件。 · @Prop装饰变量时会进行深拷贝,在拷贝的过程中除了基本类型、Map、Set、Date、Array外,都会丢失类型。例如PixelMap等通过NAPI提供的复杂类型,由于有部分实现在Native侧,因此无法在ArkTS侧通过深拷贝获得完整的数据。Prop需要被初始化,如果没有进行本地初始化的,则必须通过父组件进行初始化。如果进行了本地初始化,那么是可以不通过父组件进行初始化的。· @Prop装饰器不能在@Entry装饰的自定义组件中使用。· Link 双向 子组件 必选 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 即父组件中状态变量更新,引起相关子组件的@Link的更新。 1. @Link装饰器不能在@Entry装饰的自定义组件中使用。@Link装饰的变量禁止本地初始化,否则编译期会报错。2. 在子组件中使用@Link装饰状态变量需要保证该变量与数据源类型完全相同,且该数据源需为被诸如@State等装饰器装饰的状态变量。3. 当@State变量放在build函数后定义,用来初始化@Link变量时,会被识别为常量,而@Link变量不能被常量初始化,所以会造成编译报错。 Provide 双向 子组件 必须 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 1. @Provider/@Consumer的参数key必须为string类型,否则编译期会报错。 Consume 双向 子组件 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。支持ArkUI框架定义的联合类型Length、ResourceStr、ResourceColor类型。必须指定类型。 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 1. @Consume装饰的变量不能本地初始化,也不能在构造参数中传入初始化,否则编译期会报错。@Consume仅能通过key来匹配对应的@Provide变量进行初始化。在此场景下,CustomWidget执行this.builder()创建子组件CustomWidgetChild时,this指向的是HomePage。因此找不到CustomWidget的@Provide变量,所以下面示例会报找不到@Provide错误,和@BuilderParam连用的时候要谨慎this的指向。)等通过NAPI提供的复杂类型,由于有部分实现在Native侧,因此无法在ArkTS侧通过深拷贝获得完整的数据。Prop需要被初始化,如果没有进行本地初始化的,则必须通过父组件进行初始化。如果进行了本地初始化,那么是可以不通过父组件进行初始化的。· @Prop装饰器不能在@Entry装饰的自定义组件中使用。· |
| Link | 双向 | 子组件 | 必选 | Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 | 即父组件中状态变量更新,引起相关子组件的@Link的更新。 | 1. @Link装饰器不能在[@Entry](#状态名 同步 位置 初始值 变量类型 不支持的UL刷新 注意事项 State 父组件 必填 Object、classstring、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 对象的对象数组属性更新数组对象的属性更新 @ State装饰的变量必须初始化,否则编译期会报错。@State不支持装饰Function类型的变量,框架会抛出运行错误。 Prop 单项 子组件 不必填 Object、class、string、number、boolean、enum类型,以及这些类型的数组。不支持any,支持undefined和null。支持Date类型。 Prop变量允许在本地修改,但修改后的变化不会同步回父组件。 · @Prop装饰变量时会进行深拷贝,在拷贝的过程中除了基本类型、Map、Set、Date、Array外,都会丢失类型。例如PixelMap等通过NAPI提供的复杂类型,由于有部分实现在Native侧,因此无法在ArkTS侧通过深拷贝获得完整的数据。Prop需要被初始化,如果没有进行本地初始化的,则必须通过父组件进行初始化。如果进行了本地初始化,那么是可以不通过父组件进行初始化的。· @Prop装饰器不能在@Entry装饰的自定义组件中使用。· Link 双向 子组件 必选 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 即父组件中状态变量更新,引起相关子组件的@Link的更新。 1. @Link装饰器不能在@Entry装饰的自定义组件中使用。@Link装饰的变量禁止本地初始化,否则编译期会报错。2. 在子组件中使用@Link装饰状态变量需要保证该变量与数据源类型完全相同,且该数据源需为被诸如@State等装饰器装饰的状态变量。3. 当@State变量放在build函数后定义,用来初始化@Link变量时,会被识别为常量,而@Link变量不能被常量初始化,所以会造成编译报错。 Provide 双向 子组件 必须 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 1. @Provider/@Consumer的参数key必须为string类型,否则编译期会报错。 Consume 双向 子组件 Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。支持ArkUI框架定义的联合类型Length、ResourceStr、ResourceColor类型。必须指定类型。 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 1. @Consume装饰的变量不能本地初始化,也不能在构造参数中传入初始化,否则编译期会报错。@Consume仅能通过key来匹配对应的@Provide变量进行初始化。在此场景下,CustomWidget执行this.builder()创建子组件CustomWidgetChild时,this指向的是HomePage。因此找不到CustomWidget的@Provide变量,所以下面示例会报找不到@Provide错误,和@BuilderParam连用的时候要谨慎this的指向。)装饰的自定义组件中使用。@Link装饰的变量禁止本地初始化,否则编译期会报错。2. 在子组件中使用@Link装饰状态变量需要保证该变量与数据源类型完全相同,且该数据源需为被诸如@State等装饰器装饰的状态变量。3. 当@State变量放在build函数后定义,用来初始化@Link变量时,会被识别为常量,而@Link变量不能被常量初始化,所以会造成编译报错。 |
| Provide | 双向 | 子组件 | 必须 | Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。 | 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 | 1. @Provider/@Consumer的参数key必须为string类型,否则编译期会报错。 |
| *Consume* | 双向 | 子组件 | Object、class、string、number、boolean、enum类型,以及这些类型的数组。支持Date类型。支持ArkUI框架定义的联合类型Length、ResourceStr、ResourceColor类型。必须指定类型。 | 点击父组件Parent中的Button改变count的属性或者类型,Child中也会对应刷新。 | 1. @Consume装饰的变量不能本地初始化,也不能在构造参数中传入初始化,否则编译期会报错。@Consume仅能通过key来匹配对应的@Provide变量进行初始化。在此场景下,CustomWidget执行this.builder()创建子组件CustomWidgetChild时,this指向的是HomePage。因此找不到CustomWidget的@Provide变量,所以下面示例会报找不到@Provide错误,和@BuilderParam连用的时候要谨慎this的指向。 |
初始值变量类型
诗歌难吟4642025-01-07 16:04
相关推荐
崔庆才丨静觅4 小时前
hCaptcha 验证码图像识别 API 对接教程曹牧5 小时前
Spring Boot:如何测试Java Controller中的POST请求?passerby60615 小时前
完成前端时间处理的另一块版图掘了5 小时前
「2025 年终总结」在所有失去的人中,我最怀念我自己崔庆才丨静觅5 小时前
实用免费的 Short URL 短链接 API 对接说明崔庆才丨静觅5 小时前
5分钟快速搭建 AI 平台并用它赚钱!爬山算法6 小时前
Hibernate(90)如何在故障注入测试中使用Hibernate?kfyty7256 小时前
集成 spring-ai 2.x 实践中遇到的一些问题及解决方案猫头虎6 小时前
如何排查并解决项目启动时报错Error encountered while processing: java.io.IOException: closed 的问题李少兄6 小时前
在 IntelliJ IDEA 中修改 Git 远程仓库地址