鸿蒙Harmony--状态管理器--@Prop详解

纵横千里独行客,何惧前路雨潇潇。夜半浊酒慰寂寞,天明走马入红尘。且将新火试新茶,诗酒趁年华。青春以末,壮志照旧,生活以悟,前路未明。时间善变,可执着翻不了篇。时光磨我少年心,却难灭我少年志,壮士活古不活皮。加油。

程序员必备的面试技巧

目录

一,定义

二,装饰器使用规则说明

三,变量的传递/访问规则说明

四,使用

1,简单使用

2,装饰复杂类型

3,@State和@Prop的同步场景

4,父组件@State到子组件@Prop简单数据类型同步

5,父组件@State到子组件@Prop复杂数据类型同步

注意事项

一,定义

@Prop装饰的变量可以和父组件建立单向的同步关系。@Prop装饰的变量是可变的,但是变化不会同步回其父组件。

@Prop装饰的变量和父组件建立单向的同步关系:

①@Prop变量允许在本地修改,但修改后的变化不会同步回父组件。

②当数据源更改时,@Prop装饰的变量都会更新,并且会覆盖本地所有更改。因此,数值的同步是父组件到子组件(所属组件),子组件数值的变化不会同步到父组件。

!注意:

①@Prop修饰复杂类型时是深拷贝,在拷贝的过程中除了基本类型、Map、Set、Date、Array外,都会丢失类型。

②@Prop装饰器不能在@Entry装饰的自定义组件中使用。

二,装饰器使用规则说明

@Prop变量装饰器 说明
装饰器参数
同步类型 单向同步:对父组件状态变量值的修改,将同步给子组件@Prop装饰的变量,子组件@Prop变量的修改不会同步到父组件的状态变量上。
允许装饰的变量类型 Object、class、string、number、boolean、enum类型,以及这些类型的数组。 不支持any,不支持简单类型和复杂类型的联合类型,不允许使用undefined和null。 支持Date类型。 必须指定类型。 说明 : 不支持Length、ResourceStr、ResourceColor类型,Length,ResourceStr、ResourceColor为简单类型和复杂类型的联合类型。 在父组件中,传递给@Prop装饰的值不能为undefined或者null,反例如下所示。 CompA ({ aProp: undefined }) CompA ({ aProp: null }) @Prop和数据源类型需要相同,有以下三种情况: - @Prop装饰的变量和@State以及其他装饰器同步时双方的类型必须相同 - @Prop装饰的变量和@State以及其他装饰器装饰的数组的项同步时 ,@Prop的类型需要和@State装饰的数组的数组项相同,比如@Prop : T和@State : Array<T> - 当父组件状态变量为Object或者class时,@Prop装饰的变量和父组件状态变量的属性类型相同
嵌套传递层数 在组件复用场景,建议@Prop深度嵌套数据不要超过5层,嵌套太多会导致深拷贝占用的空间过大以及GarbageCollection(垃圾回收),引起性能问题,此时更建议使用@ObjectLink
被装饰变量的初始值 允许本地初始化。

三,变量的传递/访问规则说明

传递/访问 说明
从父组件初始化 如果本地有初始化,则是可选的。没有的话,则必选,支持父组件中的常规变量(常规变量对@Prop赋值,只是数值的初始化,常规变量的变化不会触发UI刷新。只有状态变量才能触发UI刷新)、@State、@Link、@Prop、@Provide、@Consume、@ObjectLink、@StorageLink、@StorageProp、@LocalStorageLink和@LocalStorageProp去初始化子组件中的@Prop变量。
用于初始化子组件 @Prop支持去初始化子组件中的常规变量、@State、@Link、@Prop、@Provide。
是否支持组件外访问 @Prop装饰的变量是私有的,只能在组件内访问。

四,使用

1,简单使用

创建组件,只能在组件中使用

TypeScript 复制代码
@Component
export default struct PropTest {
  @Prop yuanZhen:string ="222"

  build() {
    Row() {
      Column() {
        Text("name:" + this.yuanZhen)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.yuanZhen = "888"
          })
      }.width('100%')
    }.height('100%')
  }
}

引用组件:

TypeScript 复制代码
import PropTest from './PropTest';

@Entry
@Component
struct Index {

  build() {
    Column(){
      PropTest()
    }
  }
}

运行:

点击

2,装饰复杂类型

创建两个类:

TypeScript 复制代码
export default class YuanZhen {

  public name: string = 'YuanZhen';

  public age: number = 18;

  constructor(name: string, age: number) {
    this.name = name
    this.age = age
  }
}
TypeScript 复制代码
import YuanZhen from './YuanZhen';

export default class Yuan {

  public number: number = 1;
  public yuanZhen: YuanZhen = new YuanZhen('yuanzhen', 18);

  constructor(number: number, yuanZhen: YuanZhen) {
    this.number = number
    this.yuanZhen = yuanZhen
  }
}

在组件中应用:

TypeScript 复制代码
import Yuan from './bean/Yuan'

@Component
export default struct PropTest {
  @Prop yuanZhen:Yuan

  build() {
    Row() {
      Column() {
        Text("name:" + this.yuanZhen.yuanZhen.name+"\nage:"+this.yuanZhen.yuanZhen.age+"\nnumber:"+this.yuanZhen.number)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.yuanZhen.number=26
            this.yuanZhen.yuanZhen.age=30
            this.yuanZhen.yuanZhen.name="袁世震"
          })
      }.width('100%')
    }.height('100%')
  }
}

传值给组件:

TypeScript 复制代码
import Yuan from './bean/Yuan';
import YuanZhen from './bean/YuanZhen';
import PropTest from './PropTest';

@Entry
@Component
struct Index {

  build() {
    Column(){
      PropTest({yuanZhen:new Yuan(1,new YuanZhen("袁震",22))})
    }
  }
}

结果:

点击后

所以,当装饰的类型是Object或者class复杂类型时,可以观察到所有的属性的变化

3,@State和@Prop的同步场景

①使用父组件中@State变量的值初始化子组件中的@Prop变量。当@State变量变化时,该变量值也会同步更新至@Prop变量。

②@Prop装饰的变量的修改不会影响其数据源@State装饰变量的值。

③除了@State,数据源也可以用@Link或@Prop装饰,对@Prop的同步机制是相同的。

④数据源和@Prop变量的类型需要相同,@Prop允许简单类型和class类型。

!注意:

  1. 初始渲染:

    1. 执行父组件的build()函数将创建子组件的新实例,将数据源传递给子组件;
    2. 初始化子组件@Prop装饰的变量。
  2. 更新:

    1. 子组件@Prop更新时,更新仅停留在当前子组件,不会同步回父组件;
    2. 当父组件的数据源更新时,子组件的@Prop装饰的变量将被来自父组件的数据源重置,所有@Prop装饰的本地的修改将被父组件的更新覆盖。

4,父组件@State到子组件@Prop简单数据类型同步

在父组件定义一个变量a,并传递到子组件

TypeScript 复制代码
import PropTest from './PropTest';

@Entry
@Component
struct Index {

  @State a:number=2

  build() {
    Column(){
      Text("a="+this.a)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
           this.a =66
        })
      PropTest({a:this.a})
    }
  }
}
TypeScript 复制代码
@Component
export default struct PropTest {
  @Prop a:number

  build() {
    Row() {
      Column() {
        Text("a:" +this.a)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.a =888
          })
      }.width('100%')
    }.height('100%')
  }
}

运行:

当点击上面的a=2时,运行结果

当点击a:66时,运行结果:

所以:当父组件的数据源更新时,子组件的@Prop装饰的变量将被来自父组件的数据源重置,所有@Prop装饰的本地的修改将被父组件的更新覆盖,当子组件@Prop更新时,更新仅停留在当前子组件,不会同步回父组件

5,父组件@State到子组件@Prop复杂数据类型同步

父组件:

TypeScript 复制代码
import Yuan from './bean/Yuan';
import YuanZhen from './bean/YuanZhen';
import PropTest from './PropTest';

@Entry
@Component
struct Index {

  @State yuan:Yuan=new Yuan(2,new YuanZhen("袁震",18))

  build() {
    Column(){
      Text("name:" + this.yuan.yuanZhen.name+"\nage:"+this.yuan.yuanZhen.age+"\nnumber:"+this.yuan.number)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .onClick(() => {
          this.yuan.number=1
          this.yuan.yuanZhen.age=32
          this.yuan.yuanZhen.name="袁震1"
        })
      PropTest({yuan:this.yuan})
    }
  }
}

子组件:

TypeScript 复制代码
import Yuan from './bean/Yuan'

@Component
export default struct PropTest {
  @Prop yuan:Yuan


  build() {
    Row() {
      Column() {
        Text("name:" + this.yuan.yuanZhen.name+"\nage:"+this.yuan.yuanZhen.age+"\nnumber:"+this.yuan.number)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            this.yuan.number=26
            this.yuan.yuanZhen.age=30
            this.yuan.yuanZhen.name="袁世震"
          })
      }.width('100%')
    }.height('100%')
  }
}

运行:

点击上面的text:

点击下面的text:

注意事项

@Prop需要被初始化,如果没有进行本地初始化的,则必须通过父组件进行初始化。如果进行了本地初始化,那么是可以不通过父组件进行初始化的。

相关推荐
鸿蒙自习室7 小时前
鸿蒙多线程开发——线程间数据通信对象02
ui·harmonyos·鸿蒙
SuperHeroWu79 小时前
【HarmonyOS】鸿蒙应用接入微博分享
华为·harmonyos·鸿蒙·微博·微博分享·微博sdk集成·sdk集成
郝晨妤1 天前
鸿蒙原生应用开发元服务 元服务是什么?和App的关系?(保姆级步骤)
android·ios·华为od·华为·华为云·harmonyos·鸿蒙
Peace*1 天前
HarmonyOs鸿蒙开发实战(16)=>沉浸式效果第一种方案一窗口全屏布局方案
harmonyos·鸿蒙·鸿蒙系统
遇到困难睡大觉哈哈2 天前
ArkTS组件结构和状态管理
鸿蒙
ChinaDragonDreamer2 天前
HarmonyOS:UIAbility组件间交互(设备内)
开发语言·harmonyos·鸿蒙
ChinaDragonDreamer3 天前
HarmonyOS:使用常用组件构建页面
开发语言·harmonyos·鸿蒙
鸿蒙自习室4 天前
鸿蒙动画开发07——粒子动画
ui·华为·harmonyos·鸿蒙
少恭写代码4 天前
Taro首个支持鸿蒙的 UI 库,同时还兼容 React Native、小程序、H5
react native·鸿蒙·taro·duxapp
zhongcx015 天前
鸿蒙NEXT开发案例:计数器
华为·harmonyos·鸿蒙·鸿蒙next