文档开发者中心
我的
|

ArkUI (方舟UI框架)

ArkWeb

HarmonyOS 5

ArkTS

Ability (程序框架)

HarmonyOS 在Builder中使用自定义组件时UI不刷新 (API12+)

HarmonyOS 在Builder中使用自定义组件时UI不刷新 (API12+)

点赞
收藏
回复
1
分享
举报
浏览152 发布于2026-01-05 09:31未知归属地
全部评论
最多点赞
最新发布
最早发布
|
技术支持

【背景知识】

@Builder装饰的函数也称为“自定义构建函数”。

@Prop装饰器:父子单向同步。

【解决方案】

请按照以下两个方向进行排查:

  1. 调用@Builder装饰的函数默认按值传递。当传递的参数为状态变量时,状态变量的改变不会引起@Builder函数内的UI刷新。所以当使用状态变量的时候,推荐使用按引用传递。

  2. 当要实现父子单向同步更新时,需要使用@Prop装饰器。

@Prop装饰器装饰的变量可以和父组件建立单向的同步关系。初始渲染时:

1.执行父组件的build()函数将创建子组件的新实例,将数据源传递给子组件。

2.初始化子组件@Prop装饰的变量。

参考示例:在@Builder内创建自定义组件传递参数不刷新问题。

1楼回复于2026-01-05 09:31 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。