鸿蒙 ArkTS 状态管理实践:@State、@Prop 与 @Link 的分工

举报
yd_214121775 发表于 2026/11/13 15:14:10 2026/11/13
【摘要】 在鸿蒙 ArkUI 声明式开发中,状态管理是决定代码可维护性的关键。ArkTS 提供了 @State、@Prop、@Link 等多种装饰器,很多开发者在父子组件传值时容易混用,导致 UI 不刷新或数据不同步。本文结合实践梳理三者的分工。@State:组件内部的状态源@State 装饰的变量是组件自身持有的状态,变化时驱动当前组件 UI 刷新。它应当作为状态的拥有者,只在组件内部修改。典型写法...

在鸿蒙 ArkUI 声明式开发中,状态管理是决定代码可维护性的关键。ArkTS 提供了 @State、@Prop、@Link 等多种装饰器,很多开发者在父子组件传值时容易混用,导致 UI 不刷新或数据不同步。本文结合实践梳理三者的分工。

@State:组件内部的状态源

@State 装饰的变量是组件自身持有的状态,变化时驱动当前组件 UI 刷新。它应当作为状态的拥有者,只在组件内部修改。

典型写法是 @Entry 组件内用 @State 持有计数、输入框值等私有状态,通过 onClick 等事件更新,ArkUI 会自动触发重建。

@Prop:父到子的单向传递

@Prop 用于子组件接收父组件状态,父组件更新会同步到子组件,但子组件对 @Prop 的修改不会回传父组件。它适合只读展示加本地覆盖的场景,例如子组件需要在父值基础上做临时编辑。

@Link:父子双向绑定

@Link 与父组件的 @State 建立双向引用,子组件修改会回写父组件。需要注意 @Link 变量不能在子组件本地初始化,必须由父组件通过美元符号传入引用。

选型建议

状态应当只有一个真实来源:组件私有状态用 @State;父传子只读用 @Prop;需要双向同步用 @Link。避免在多处各持一份 @State 再手动同步,那是最容易引入数据不一致的写法。

合理拆分状态归属,能让 ArkUI 的刷新链路更清晰,也让组件复用更稳妥。在大型页面里,建议把共享状态上移到最近的公共祖先,再用 @Prop 或 @Link 按需下发。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。