| 状态名 | 同步 | 位置 | 初始值 | 变量类型 | 不支持的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
相关推荐
其实防守也摸鱼1 小时前
个人学习 Pwn 思路:从基础到漏洞利用的进阶路径风若飞1 小时前
Spring Ai 入门遇到问题1Nuanyt1 小时前
LeetCode Hot 100 链表专题(五)· 2 题(Java)朱涛的自习室2 小时前
212 个需求、22 万行代码:Agent 接管开源项目的 19 天aZhe的全栈知识分享2 小时前
AI 还原 Figma 效果总达不到预期?先别急着让它写代码review445432 小时前
Codex Hooks 入门实战:生命周期事件、matcher 与5分钟跑通一个钩子函数小陈2 小时前
阿里云部署DSH与RAM完成运维用户499335025072 小时前
JS 作用域劫持的死穴:动态 this 穿透,以及 AST 怎么救黑马程序员毕设2 小时前
基于 Java 的餐饮点餐系统设计与应用报告SL_staff2 小时前
从文档工具到知识中枢:基于JVS数字底座构建企业级统一内容管理平台的技术实践