ArkUI 声明式 UI 入门实践:布局、状态与列表渲染的几个关键点

举报
yd_222757319 发表于 2026/11/19 00:05:48 2026/11/19
【摘要】 用一个小型列表应用梳理 ArkUI 的声明式写法:常用布局容器、状态驱动刷新、列表渲染与性能注意事项。

ArkUI 的声明式写法和传统命令式 UI 差别不小,初学时最容易犯的错是“先写界面再想数据”。这里用一个列表增删改的例子,把几个关键点梳理一遍。

一、布局容器怎么选

横向排列用 Row,纵向用 Column,需要层叠用 Stack,需要按比例分配空间用 Flex 或者给子组件设 layoutWeight。实际写的时候建议先画结构再落代码,容器嵌套过深会让布局计算变慢,也没必要。

二、状态驱动刷新

@State 修饰的变量变化会触发所在组件重建,@Prop 用于父传子的单向同步,@Link 用于双向。最容易踩的坑是把状态声明在错误的位置:状态放在子组件里,父组件改不动;放在父组件又层层透传。原则是“谁的数据谁持有,谁需要读谁接收”。

三、列表渲染

列表用 List 配合 ForEach,key 生成函数一定要稳定。用索引当 key,在插入或删除时会导致复用错位,表现为点击某一项却选中了另一项。用数据自身的唯一 id 做 key 就不会有这个问题。

四、副作用与生命周期

请求数据放在 aboutToAppear,不要在 build 里发起网络请求。build 可能被多次执行,在里面做副作用会导致重复请求甚至循环刷新。

五、调试经验

布局不生效时先用背景色把每个容器画出来,确认层级和尺寸;状态不刷新时先检查是不是直接改了对象内部字段而没有替换引用,ArkUI 对引用变化的感知需要整体替换或者使用支持观察的对象。

六、小结

ArkUI 上手不难,难的是保持“数据驱动视图”的习惯。把状态归属想清楚、key 用稳定值、副作用放在生命周期里,大部分常见问题都能提前避开。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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