HarmonyOS - 组件外部输入状态管理装饰器:Param

前言

在上篇文章中,我们介绍了组件内部状态管理装饰器 Local 的使用方式和注意事项。但在实际开发场景中,并不总是管理组件内部的状态,大部分的场景我们需要与外部组件进行交互,这就用到了今天要介绍的状态管理装饰器:Param

Param

状态管理装饰器 Param 的作用是用来接受组件外部的输入。假设我们遇到这样一个开发场景:登录按钮要根据用户是否同意用户协议来改变它的状态,用户同意则登录按钮可用,用户不同意则按钮置灰。示例代码如下:

less 复制代码
@Entry
@ComponentV2
struct Index {
  @Local isOn: boolean = true;
  build() {
    Column() {
      Toggle({ type: ToggleType.Switch, isOn: $$this.isOn })
        .selectedColor('#007DFF')
        .switchPointColor('#FFFFFF')
        .onChange((isOn: boolean) => {
          console.info('Component status:' + isOn);
        })

      Child({isOn: this.isOn})
    }
    .width('100%')
    .height('100%')
  }
}

@ComponentV2
struct Child {
  @Param isOn: boolean = true;
  build() {
    Column() {
      Button("登录")
        .enabled(this.isOn)
    }
  }
}

UI 方面,我们用 Toggle 组件来模拟用户同意或不同意的操作。通过 Child 组件来展示登录按钮。在状态管理方面, Index 中有一个组件内的状态 isOn,我们通过双刀乐符号将其与 Toggle 的状态进行双向绑定。最后,在 Child 组件中,通过 @Param 修饰的 isOn 来控制登录按钮的状态。

这是 isOn 为 true 的示例图: 这是 isOn 为 false 的示例图:

了解完 Param 的基本用法后,我们来看一下它的注意事项。

注意事项

第一点需要注意的就是,Param 修饰的变量可以本地初始化,也可以外部进行传入。但两个条件必须满足一个,也就是说既没有本地初始化也没有外部传入的话,编译器报错。若是既进行了本地初始化,又在外部进行了传入,那外部传入的值会覆盖掉本地初始化的值。

本地初始化的示例代码上面已给出,下面看一下仅外部传入的方式,需要用 @Require 修饰:

less 复制代码
@Param @Require isOn: boolean;

若没有 @Require 修饰会编译报错:

sql 复制代码
// When a variable decorated with @Param is not assigned a default value, it must also be decorated with @Require. <ArkTSCheck>
@Param isOn: boolean;

第二个需要注意的就是 Param 修饰的变量是无法直接进行本地修改的,会编译报错:

kotlin 复制代码
Button("登录")
  .enabled(this.isOn)
  .onClick(() => {
  //Cannot assign to 'isOn' because it is a read-only property. <ArkTSCheck>
    this.isOn = false
  })

因为 Param 默认的是父子单向同步,若要实现父子双向同步的功能需要借助 @Event 来实现。

第三个和 Local 的限制一样,如果它修饰的是类,只能检测到类的赋值变化,检测不到类属性的变化。这里就不具体举代码示例了,跟 Local 中的逻辑是类似的。

总结

  • Param 用于组件外部输入状态,父子单向同步。
  • 它可以本地初始化,也可以外部输入。不能既没有本地初始化,也没有外部输入,若是要求外部输入需用 @Require
  • 本地无法修改,需配合 @Event
  • 如果修饰类,仅能观测到赋值变化,无法观测的属性变化。
相关推荐
zhanshuo2 小时前
ArkUI 玩转水平滑动视图:超全实战教程与项目应用解析
harmonyos·arkui
zhanshuo2 小时前
ArkUI Canvas 实战:快速绘制柱状图图表组件
harmonyos·arkui
zhanshuo17 小时前
手把手教你用 ArkUI 写出高性能分页列表:List + onScroll 实战解析
harmonyos
zhanshuo17 小时前
深入解析 ArkUI 触摸事件机制:从点击到滑动的开发全流程
harmonyos
i仙银1 天前
鸿蒙沙箱浏览器 - SandboxFinder
app·harmonyos
Georgewu1 天前
【HarmonyOS】鸿蒙应用开发中常用的三方库介绍和使用示例
harmonyos
AORO20251 天前
遨游三防平板|国产芯片鸿蒙系统单北斗三防平板,安全高效
5g·安全·电脑·制造·信息与通信·harmonyos
HarmonyOS小助手1 天前
“秒开”时代,HarmonyOS预加载让应用启动快如闪电
harmonyos·鸿蒙·鸿蒙生态
三翼鸟数字化技术团队2 天前
鸿蒙平台运行Lua脚本
lua·harmonyos