目录

@Param和@Once相较于@Prop、@Link的使用场景及优势

问题现象

背景知识

状态管理V2中组件内状态变量装饰器,相较于状态管理V1中组件内状态变量装饰器更加注重本地初始化数据和传入数据的限制与区分:

解决方案

问题现象中的场景与解决方案总结如下:

场景

场景描述

解决方案

场景一

父组件传入子组件的变量不是状态变量时,如何刷新子组件内@Param装饰的参数?

1. 通过其它状态变量的改变强制刷新子组件内普通变量。2. 将普通变量的数据封装到@ObservedV2/@Trace装饰的类里,通过@Trace刷新子组件UI。

场景二

@Param与@Prop、@Link之间的差异,以及如何将V1的@Prop、@Link迁移至V2的@Param?

参考@Prop->@Param、@Link->@Param/@Event。

场景三

状态管理V1中由于@State、@Prop、@Link、@Provide等装饰器均能接收参数,应该如何分辨哪些参数需要传递?

使用状态管理V2的@Param装饰器接收外部传入的参数、@Local等装饰器初始化本地参数,从而有效区分哪些参数需要外部传入,哪些参数是本地初始化。

常见FAQ

Q:使用@CustomDialog装饰器装饰自定义组件,在该组件中使用@Param后报错。

A:@Param装饰器可增强子组件接受外部参数输入的能力,但@Param装饰器只能在@ComponentV2装饰器的自定义组件中使用,可参考链接:@Param的使用限制。

Q:@Param支持本地默认初始化,@Link是否也可以?

A:@Link不支持本地初始化,必须通过外部传入初始化。

Q:@Param装饰器处理外部输入时出现了错误,该如何排查?

A:参考排查如下:

  1. 检查输入参数类型:确保传递给@Param装饰器的参数类型与预期一致。不匹配的数据类型可能会导致运行时错误。
  2. 验证参数值的有效性:确保所有通过@Param装饰器传递的参数值都是有效的,并且符合业务逻辑的要求。

总结

@Link、@Prop与@Param分别为状态管理V1和状态管理V2的主要接收参数的装饰器,其差异与对比如下:

装饰器

@Link

@Prop

@Param

状态管理版本

状态管理V1

状态管理V1

状态管理V2

初始化规则

@Link装饰的变量不能本地初始化,只能通过父组件传入,若父组件未传入则会校验报错。

@Prop装饰的变量允许本地初始化,若无本地初始化则必须从外部传入初始化。当同时存在本地初始值与外部传入值时,优先使用外部传入值进行初始化。

1. @Param装饰的变量允许本地初始化,若无本地初始化则必须从外部传入初始化。当同时存在本地初始值与外部传入值时,优先使用外部传入值进行初始化。2. 当@Param搭配@Require一起使用时,不允许本地初始化,只能通过父组件传入,若父组件未传入则会校验报错。

同步规则

双向同步。父组件状态变量与子组件@Link建立双向同步,当其中一方改变时,另一方也会同步更新。

单向同步。对父组件状态变量值的修改,将同步给子组件@Prop装饰的变量,子组件@Prop装饰的变量的修改不会同步到父组件的状态变量上。

1. 单向同步。对父组件状态变量值的修改,将同步给子组件@Param装饰的变量。2. 双向同步。@Param搭配@Event装饰器在子组件内调用父组件传递的函数,修改父组件的变量(若接收的是对象,且改变的是对象属性时,无需搭配@Event,可以通过@ObservedV2/@Trace装饰的数据源实现双向同步,详见官网:使用限制)。3. 单向首次同步。搭配@Once只接收第一次父组件向子组件传递的参数,父组件后续的修改,将不会再同步给子组件。

通过上述差异对比,状态管理V1与状态管理V2在参数传递方面优缺点如下:

状态管理版本

状态管理V1

状态管理V2

优缺点

@Link、@Prop分别支持双向与单向传递,但是不支持单向首次同步。只能通过@State、@Provide等装饰的状态变量以及没有装饰器装饰的普通变量接收外部传参实现单向首次同步,导致@State、@Provide等其它本地化初始化的变量与需要单向首次同步的变量无法区分,组件内参数较多时,维护成本高。

通过在@Param的基础上搭配不同装饰器可分别实现单向同步、双向同步、单向首次同步。实现与@Local、@Provider等本地初始化变量的有效区分。组件内参数较多时,维护成本较低。