鸿蒙 ArkTS 状态管理实践:@State、@Prop 与 @Link 的分工
【摘要】 在鸿蒙 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)