自定义博客皮肤VIP专享

*博客头图:

格式为PNG、JPG,宽度*高度大于1920*100像素,不超过2MB,主视觉建议放在右侧,请参照线上博客头图

请上传大于1920*100像素的图片!

博客底图:

图片格式为PNG、JPG,不超过1MB,可上下左右平铺至整个背景

栏目图:

图片格式为PNG、JPG,图片宽度*高度为300*38像素,不超过0.5MB

主标题颜色:

RGB颜色,例如:#AFAFAF

Hover:

RGB颜色,例如:#AFAFAF

副标题颜色:

RGB颜色,例如:#AFAFAF

自定义博客皮肤

-+
  • 博客(101)
  • 收藏
  • 关注

原创 HarmonyOS7 端侧搜索的小型索引:ArkUI/ArkTS 实战拆解

端侧搜索适合小数据、高频输入的场景。联系人、功能入口、城市列表这类内容,如果每敲一个字都请求网络,体验反而会被抖动拖慢。这篇单独聊联系人搜索这个场景。重点不是堆 API,而是为小数据量建立端侧索引,让高频输入时列表即时响应。数据量继续变大时,不要硬扛本地过滤。几百条以内端侧索引很舒服,更多数据就要考虑分页、后端搜索或更专业的索引结构。搜索方案要跟数据量匹配,不能只看当前 mock 数据很顺。

2026-08-12 09:35:56 248

原创 HarmonyOS7 分布式流转入口的 UI 提示:ArkUI/ArkTS 实战拆解

分布式流转能力本身很强,但入口文案如果只写“流转”,用户很难判断会发生什么。UI 需要说清楚目标设备、当前可用性和发起后的反馈。这篇单独聊跨设备这个场景。重点不是堆 API,而是让分布式入口清楚说明目标设备、当前可用性和发起后的 UI 反馈。真实项目里,设备发现、账号一致性、网络状态和权限状态都可能影响入口可用性。UI 不需要暴露所有技术细节,但要把用户能理解的原因讲明白,例如“暂未发现附近设备”或“请确认两台设备登录同一账号”。

2026-08-12 09:35:34 181

原创 HarmonyOS7 状态机管理复杂表单:ArkUI/ArkTS 实战拆解

复杂表单真正难的不是输入框多,而是流程状态多。草稿、校验失败、提交中、已提交、被驳回如果都靠布尔值拼,很容易出现非法组合。这篇单独聊报销申请这个场景。重点不是堆 API,而是用状态机约束复杂表单的草稿、校验失败、提交中和已提交流程。后续如果增加“被驳回”“草稿已保存”“等待审批”,也应该继续扩展状态和迁移动作,而不是再随手加布尔值。流程越复杂,越要先问清楚:当前状态下允许用户做什么。

2026-08-11 09:24:14 143

原创 HarmonyOS7 弹性布局处理异常文案:ArkUI/ArkTS 实战拆解

异常文案是检验布局韧性的最好材料。标题一长、按钮一多、屏幕一窄,平时看起来很整齐的卡片就可能把操作区挤没。这篇单独聊长标题卡片这个场景。重点不是堆 API,而是用弹性布局保证极端文案、按钮和状态标签不会互相挤压。测试时不要只放正常中文短句。英文长串、设备编号、异常码、系统字号放大、多语言翻译都会给布局制造压力。能扛住这些异常文案,卡片才算真正稳定。

2026-08-11 09:23:53 274

原创 HarmonyOS7 页面骨架如何做成组件:ArkUI/ArkTS 实战拆解

骨架屏不是灰色占位块越多越专业。它应该贴近真实页面结构,让用户知道内容正在加载,也让页面从加载到完成时不会明显跳动。这篇单独聊通用加载这个场景。重点不是堆 API,而是把骨架屏抽成足够小的 ArkUI 构建器,让加载态贴近真实页面结构。失败态要和加载态分开。骨架只表示“正在加载”,接口失败后应该切到错误提示和重试入口。如果骨架无限显示,用户会以为还在等待,实际已经没有下一步了。

2026-08-11 09:23:32 325

原创 HarmonyOS7 颜色 Token 让主题更稳:ArkUI/ArkTS 实战拆解

颜色 token 的重点不是把色值藏起来,而是让颜色具备语义。品牌色、危险色、辅助文字、页面背景这些角色稳定了,主题切换才不会牵一发动全身。这篇单独聊品牌页这个场景。重点不是堆 API,而是把品牌色、危险色、辅助文字和背景色按语义收口,避免主题切换时到处改组件。暗色模式尤其要注意层级。页面背景和卡片背景如果太接近,内容会糊成一片;辅助文字如果过暗,低亮度设备上会很难读。主题适配不是简单换一组色值,而是要保证信息层级仍然成立。

2026-08-11 09:23:12 349

原创 HarmonyOS7 资源尺寸别到处写数字:ArkUI/ArkTS 实战拆解

尺寸数字散落在页面里,短期看不出问题,等视觉规范调整时会非常痛苦。HarmonyOS7 页面里即使暂时不接资源文件,也应该先给核心尺寸命名。这篇单独聊通用间距这个场景。重点不是堆 API,而是给核心尺寸命名,让页面后续迁到资源或主题 token 时有清晰路径。也不要一开始就消灭所有裸数字。只在某个徽标里用一次的微调值,可以先保留;页面主间距、按钮高度、卡片圆角这类会反复出现的值,才值得优先命名。等多个页面都复用稳定后,再迁到资源文件或统一主题对象。

2026-08-11 09:22:52 302

原创 HarmonyOS7 性能排查先看渲染层级:ArkUI/ArkTS 实战拆解

性能优化不要一上来就找高级工具。很多 HarmonyOS7 页面卡顿,第一眼看代码就能发现:容器套容器、条件分支改根节点、列表项重复造结构。这篇单独聊复杂首页这个场景。重点不是堆 API,而是先从页面树、列表项结构和重复 modifier 入手排查性能问题。优化后一定要用真实数据量验证。只有三四条数据时看不出差异,换成几十条、上百条,再加上低端设备和真实图片,滚动问题才会暴露出来。渲染层级优化不是全部答案,但它通常是最容易先拿到收益的一步。

2026-08-10 09:25:09 309

原创 HarmonyOS7 日志打印要有模块名:ArkUI/ArkTS 实战拆解

日志打印不是开发时随手写一句success。等问题到了测试机、灰度包、线上用户那里,能不能按模块和动作搜到日志,直接决定排查效率。这篇单独聊登录流程这个场景。重点不是堆 API,而是让日志能按模块、动作和关键参数串起一条可追踪链路。生产环境还要控制日志边界。账号、手机号、验证码、token 都不应该明文打印;输入框变化这类高频日志也要降级或关闭。日志的目标是定位问题,不是把用户隐私和无效噪声都塞进控制台。

2026-08-10 09:24:49 303

原创 HarmonyOS7 错误边界用页面状态兜底:ArkUI/ArkTS 实战拆解

详情页最怕失败后空白。用户不知道是没数据、没权限、网络断了,还是页面坏了。HarmonyOS7 页面里我会把这些状态显式拆开,用页面状态做兜底。这篇单独聊详情页这个场景。重点不是堆 API,而是用页面状态把加载、成功、空数据和失败兜底说清楚。真实项目里建议把用户文案和开发日志分层处理。用户看到“加载失败,请检查网络后重试”,开发日志里记录模块名、订单 id、错误码和重试次数。这样既不吓用户,也能给排查留下线索。

2026-08-10 09:24:31 315

原创 HarmonyOS7 加载按钮防重复点击:ArkUI/ArkTS 实战拆解

提交按钮防重复点击不是一个视觉问题,而是业务安全问题。反馈、下单、支付、审批这些动作一旦重复触发,后端兜底再强,前端也不该放任用户连续点。这篇单独聊提交按钮这个场景。重点不是堆 API,而是把禁用态、加载态、失败重试和方法入口校验写成同一套规则。加载按钮写得好不好,看的不是它会不会变成“提交中”,而是它能不能把一次业务动作完整接住。前端守住入口,后端配合幂等,这样用户每点一次,系统才真的只算一次。

2026-08-10 09:24:10 306

原创 HarmonyOS7 标签选择器怎么处理多选:ArkUI/ArkTS 实战拆解

多选标签如果不提前设计规则,后面会在保存、回显、推荐算法里不断补丁。我的习惯是先明确最多选几个、保存什么值、用户怎么知道自己选满了。这篇单独聊兴趣标签这个场景。重点不是堆 API,而是让多选规则、数量上限、保存格式和回显文案从一开始就明确。取消选择要放在上限判断之前,这是多选交互里很关键的顺序。即使已经选满,用户也应该能取消已选标签;否则页面会像被锁住一样。选满后的弱化态只是提示,不应该阻断用户理解当前规则。

2026-08-10 09:23:49 303

原创 HarmonyOS7 分段控制器自己封一个:ArkUI/ArkTS 实战拆解

分段控制器适合处理小范围筛选。它比 Tabs 轻,比临时按钮组稳定,尤其适合订单状态、消息类型、统计周期这类“当前只能选一个”的场景。这篇单独聊订单筛选这个场景。重点不是堆 API,而是用一个轻量分段控件承接小范围单选筛选,让状态边界比临时按钮组更清楚。等宽布局也不是为了好看而已。订单状态文案长短不一,如果每段宽度随文字变化,切换时视觉重心会飘。用保持等宽,用户会更容易判断当前选中项。

2026-08-08 09:30:51 137

原创 HarmonyOS7 抽屉菜单适合轻量入口:ArkUI/ArkTS 实战拆解

抽屉菜单不是万能导航。我在项目里只把低频但需要可达的入口放进去,比如设置、帮助、消息中心;真正高频的工作流应该留在主界面上。这篇单独聊工作台这个场景。重点不是堆 API,而是判断哪些入口适合收进抽屉,以及抽屉开关状态如何不污染主业务。如果菜单项来自权限接口,稳定id也很关键。不同用户看到的入口可能不同,使用业务 id 做 key,才能避免过滤或排序后角标、选中态、点击结果错位。

2026-08-08 09:30:32 149

原创 HarmonyOS7 图片预览的手势缩放:ArkUI/ArkTS 实战拆解

图片预览的手势交互不能只追求“能放大”。真正影响体验的是缩放边界、拖动回正、双击复位和退出入口,这些细节决定用户会不会迷失在一张大图里。这篇单独聊相册预览这个场景。重点不是堆 API,而是把捏合缩放、拖动位移、双击复位和显式退出入口放到同一个页面里。真实相册预览还可以继续完善拖动边界,比如根据图片尺寸和屏幕宽度限制offsetXoffsetY。但即使先做轻量版本,也要保留显式关闭入口,不要假设每个用户都知道该用什么手势退出。

2026-08-08 09:30:09 225

原创 HarmonyOS7 评论输入框和列表联动:ArkUI/ArkTS 实战拆解

评论区的体验好坏,往往不在列表样式,而在发布后的那一瞬间:输入框有没有清空、新评论有没有出现、按钮有没有挡住无效提交。这里用 HarmonyOS7 写一个完整闭环。这篇单独聊评论区这个场景。重点不是堆 API,而是把输入草稿、发布按钮和评论列表的联动写成一个完整闭环。接真实接口时可以先插入一条本地评论,并给它一个sending状态。接口成功后替换成服务端 id,失败时显示重试入口。这样评论区既有即时反馈,又不会把失败伪装成成功。

2026-08-08 09:29:48 188

原创 HarmonyOS7 收藏按钮的乐观更新:ArkUI/ArkTS 实战拆解

立刻变状态如果失败不回滚,又会造成数据不一致。这篇重点放在乐观更新和失败恢复。这篇单独聊这个场景。重点不是堆 API,而是把用户点击后的即时反馈、接口失败和状态回滚放在同一条链路里说明白。乐观更新真正考验的,不是“变快”这一步,而是失败时还能不能把用户稳稳接回来。按钮可以先亮,数字可以先变,但一旦出错,页面必须给出一个说得通、看得见、能恢复的结果。

2026-08-08 09:29:24 301

原创 HarmonyOS7 购物车勾选联动别写乱:ArkUI/ArkTS 实战拆解

购物车勾选联动是典型的小需求大坑点。单选、全选、数量、合计金额任何一个状态多存一份,后面都可能出现“按钮显示全选但商品没全选”的问题。这篇单独聊购物车这个场景。重点不是堆 API,而是让选中态、数量和合计金额只有一条可靠的数据来源。真实购物车还会有库存不足、商品失效、限购、优惠计算等逻辑。建议先把商品项模型扩展清楚,例如增加或stockState,而不是在底部结算按钮里临时塞一堆判断。

2026-08-07 09:31:31 171

原创 HarmonyOS7 地图卡片不要塞太多按钮:ArkUI/ArkTS 实战拆解

我的经验是,地图卡片只保留最关键动作,其他操作放到信息区或更多菜单里。用户看地图时,最需要的是位置和一个明确的下一步。地图卡片的主角是位置,不是按钮数量。本文用“门店详情页”做例子。地图只是帮助用户确认位置,不应该承担全部门店操作。把按钮分层之后,页面会更容易扫读。

2026-08-07 09:31:14 166

原创 HarmonyOS7 音频播放条怎么拆组件:ArkUI/ArkTS 实战拆解

音频播放条如果全写在页面里,很快会混在一起:播放状态、进度、标题、倍速、拖动、错误提示。我的拆法是让播放条组件只关心展示和用户操作,把真正的播放器控制留给外层或服务层。播放条是控制面板,不应该变成播放器内核。本文用“播客详情页”做例子。页面上有标题、播放条、进度拖动和倍速入口,但示例会刻意让AudioBar只接收参数和回调,避免组件内部偷偷创建播放器。

2026-08-07 09:30:55 167

原创 HarmonyOS7 头像裁剪页的交互节奏:ArkUI/ArkTS 实战拆解

头像裁剪页不是简单放一张图片加两个按钮。用户需要选择图片、预览裁剪区域、确认上传,还要知道处理中不能重复点。我在 HarmonyOS7 里会先做一个清晰交互骨架,再接真实相册和图片裁剪能力。媒体处理页面要先保证节奏:选择、预览、确认、处理中、完成。本文先不绑定具体相册 API,而是把交互状态搭稳。真实项目接入图片选择、裁剪算法和上传接口时,这套页面节奏仍然成立。

2026-08-07 09:30:29 230

原创 HarmonyOS7 验证码倒计时状态机:ArkUI/ArkTS 实战拆解

验证码按钮看起来只有“发送”和“倒计时”两种状态,真实项目里却会遇到手机号无效、发送中、发送失败、倒计时未结束、页面销毁清理定时器等问题。我习惯把它写成一个小状态机,而不是在按钮文案里到处拼条件。本文用“短信登录”做例子。这个场景里验证码按钮和手机号输入强绑定:手机号不合法时不能发送,发送中不能重复点,倒计时结束后才能再次获取。因为它表面上看只是一个小按钮,很多人第一反应都是直接围着文案写条件。发送中显示发送中,倒计时就显示多少秒,失败了再补一句重新获取,好像很顺。问题是验证码按钮背后其实连着手机号校验、请

2026-08-07 09:30:04 249

原创 HarmonyOS7 密码输入框的小细节:ArkUI/ArkTS 实战拆解

密码框不是一个普通输入框换成星号那么简单。注册、改密、重置密码都需要可见性切换、强度提示、二次确认和提交禁用。让用户知道哪里不满足,但不要在每敲一个字符时用红字吓人。密码体验要克制,提示足够清楚,反馈不要过度。本文用“设置登录密码”做例子。页面目标不是把规则藏起来等用户提交失败,而是在输入过程中逐步告诉用户还差什么。

2026-08-06 09:27:13 217

原创 HarmonyOS7 键盘弹出时表单别乱跳:ArkUI/ArkTS 实战拆解

表单页最影响体验的细节之一,是键盘弹出后输入框跳来跳去。地址、备注、发票抬头这些字段本来就长,如果底部按钮再挡住输入框,用户会很烦。我更倾向于用滚动容器承载表单,把提交区固定在底部,并保证当前输入区域能滚动到可见位置。表单页面要让用户连续输入,不要让布局在每次聚焦时重新抢注意力。本文用“编辑收货地址”做例子。它有短输入、长文本、底部保存按钮和实时校验,基本覆盖了移动端表单最容易出问题的组合。

2026-08-06 09:26:52 165

原创 HarmonyOS7 吸底按钮别挡住内容:ArkUI/ArkTS 实战拆解

提交订单、确认支付、保存资料这类页面经常需要吸底按钮。问题是按钮一吸底,最后一段内容、协议说明、价格明细很容易被挡住。我在 HarmonyOS7 里处理这类页面,会把滚动内容和底部操作区明确分开,并给列表底部留出真实空间。吸底按钮的核心不是固定在底部,而是不遮挡用户必须阅读和确认的内容。

2026-08-06 09:26:30 182

原创 HarmonyOS7 横向滚动分类栏:ArkUI/ArkTS 实战拆解

横向分类栏看起来简单,实际很容易写得别扭:选中态不明显、内容宽度不稳定、分类多了之后首尾被裁掉。可横滑、选中态清晰、切换后内容同步刷新。分类栏不是装饰,它是列表数据的过滤入口,反馈必须快。本文用“餐饮菜单分类”做例子。用户横向切换“早餐、午餐、咖啡、甜品”时,下方列表应该立即跟着变化;如果分类栏只是视觉组件,没有驱动数据刷新,就会让用户误以为点击没生效。

2026-08-06 09:26:08 372

原创 HarmonyOS7 表格在手机上要换思路:ArkUI/ArkTS 实战拆解

手机屏幕不适合硬塞 PC 表格。列多了以后,字号变小、横向滚动难用、关键数据还被挤到看不见的位置。我在 HarmonyOS7 里做账单、库存、审批明细时,更倾向于把表格改成主次分明的列表卡片。移动端数据展示不是缩小表格,而是重新排序信息优先级。这篇以“账单明细”为例:PC 表格里可能有单号、名称、金额、状态、时间、发票、操作七八列,但手机上真正优先的是“这是什么账单、多少钱、现在什么状态”。

2026-08-06 09:25:48 185

原创 HarmonyOS7 后台任务状态怎么展示:ArkUI/ArkTS 实战拆解

后台任务最怕“用户不知道发生了什么”。上传、导出、同步这类动作可能持续几十秒,如果页面只给一个转圈,用户会反复点击或直接退出。我更喜欢把任务拆成队列,让每个任务都有进度、状态、失败原因和重试入口。后台任务不是一个全局 loading,它是一组可观察、可恢复的业务状态。本文用“附件上传队列”做例子。这个场景比单个 loading 更接近真实业务:用户可能一次上传多个附件,其中一个失败不应该影响其他文件继续上传。

2026-08-05 09:34:16 148

原创 HarmonyOS7 任务池别拿来做所有事:ArkUI/ArkTS 实战拆解

taskpool很有用,但我不赞成看到异步就上任务池。网络请求、简单状态切换、普通定时器,本身不需要任务池。它更适合 CPU 开销明显、输入输出边界清楚、能脱离组件实例运行的计算。并发工具不是万能胶。先判断任务性质,再决定要不要放进任务池。这篇用“销售记录本地统计”做例子。场景很具体:门店看板需要对一批本地记录做汇总,记录数量上来后,直接在 UI 线程里算会让页面点击和滚动变钝。此时可以先把计算函数写成纯函数,再决定是否迁移到任务池。HarmonyOS7 给了并发工具,但工程判断仍然重要。

2026-08-05 09:33:54 187

原创 HarmonyOS7 WebSocket 消息流怎么接 UI:ArkUI/ArkTS 实战拆解

WebSocket 接 UI 的难点不在连接成功,而在连接之后:重连、消息发送中、失败重试、重复消息、历史消息保留。我的习惯是先把消息流转成页面状态,再让 ArkUI 渲染,而不是在回调里直接拼 UI。WebSocket 是通道,不是页面状态模型。先整理数据,再刷新界面。

2026-08-05 09:33:37 264

原创 HarmonyOS7 离线提示要明显但不烦:ArkUI/ArkTS 实战拆解

离线提示做不好,用户会有两种感受:要么不知道页面为什么刷新不出来,要么被弹窗打断到烦。我在 HarmonyOS7 项目里更倾向于把离线状态做成顶部轻提示、关键按钮禁用、保留本地内容这三件事。离线提示不是为了宣布“网络坏了”,而是解释当前页面哪些能力暂时不可用。HarmonyOS7 的离线提示应该服务于任务本身:让用户知道发生了什么,还能继续做什么。我的经验是,提示越贴近当前操作,越不需要夸张的弹窗。

2026-08-05 09:33:18 209

原创 HarmonyOS7 本地缓存和刷新策略:ArkUI/ArkTS 实战拆解

资讯列表、首页推荐、个人资料这类页面,如果每次打开都等网络返回,体验会很硬。可缓存也不是简单地“存一份数据”:缓存多久过期、刷新失败怎么处理、用户看到的是旧数据还是空白页,这些都要提前想清楚。我在 HarmonyOS7 里常用的策略是先读缓存,再静默刷新,失败时保留旧内容。用户能尽快看到东西,页面也不会因为一次网络失败就完全不可用。缓存不是为了偷懒少请求,而是为了让页面在网络不稳定时仍然有基本可用性。

2026-08-05 09:32:54 226

原创 HarmonyOS7 加载更多别靠滚到底猜:ArkUI/ArkTS 实战拆解

分页列表最常见的坏味道,是把“滚到底”当成唯一条件。用户快速滑动、接口慢、最后一页为空、重复触发回调,这些情况叠在一起,列表就会出现重复数据、底部一直转圈、甚至越界请求。能不能加载、正在加载哪一页、有没有更多、失败后怎么重试。onReachEnd只是触发器,不应该承载所有判断。滚动事件只告诉你“用户快到底了”,它没有告诉你“现在一定应该请求下一页”。

2026-08-04 09:39:32 294

原创 HarmonyOS7 页面参数校验要放入口处:ArkUI/ArkTS 实战拆解

详情页崩溃,很多时候不是接口慢,也不是组件复杂,而是入口参数一开始就是脏的。比如id为空、类型不对、从通知跳进来少了字段、老版本页面还传着旧参数。参数校验如果散落在加载数据、渲染标题、点击按钮里,后面排查会很累。进入页面先得到一个可信的 ViewState,后面的 UI 只关心正常态、错误态和加载态。不要让页面里的每个角落都猜“参数是不是有效”。入口校验一次,后面少很多防御式代码。参数校验看起来是小事,但它决定了页面的下限。HarmonyOS7 页面越多、入口越复杂,就越应该把这件事前置。

2026-08-04 09:39:13 196

原创 HarmonyOS7 NavigationStack 管理页面栈:ArkUI/ArkTS 实战拆解

多级页面最容易出现的问题,不是“跳不过去”,而是返回路径和页面状态开始失控。我之前接手过一个订单模块,列表页、详情页、物流页、售后页之间互相跳,最后返回按钮的表现全靠运气。后来重构时,第一件事就是把页面栈收回到里统一管理。HarmonyOS7 里用Navigation和写页面栈,思路比散落的路由跳转更清楚:页面从哪里来、现在栈里有什么、返回到哪一层,都能在一个对象里看到。页面栈不是导航 API 的附属品,它本身就是业务状态的一部分。的价值在复杂页面里才明显。

2026-08-04 09:38:54 221

原创 HarmonyOS7 用 BuilderParam 做插槽组件:ArkUI/ArkTS 实战拆解

我在 HarmonyOS7 项目里封装卡片时,最怕遇到一种代码:标题、右侧操作、底部按钮、空状态都写死在容器组件里。短期看省事,后面业务页一多,容器组件就会长成一个到处判断的“大杂烩”。更适合解决这类问题。容器负责边框、间距、标题区和点击反馈,具体内容交给调用方自己填。这样组件不是万能组件,但会变得非常耐用。插槽组件的关键不是“看起来高级”,而是让可变区域留在外面,让稳定区域沉到组件里。HarmonyOS7 里写 ArkUI 组件,越往后越考验边界感。不是为了把组件做复杂,而是把变化点放到正确的位置。

2026-08-04 09:38:34 174

原创 HarmonyOS7 组件参数命名决定可维护性:ArkUI/ArkTS 实战拆解

组件参数命名看起来是小事,实际会直接影响维护成本。HarmonyOS7 的 ArkUI 组件经常通过@Prop@Link和回调传递数据,如果参数叫datainfovalue,短期能写,长期会让调用方猜含义。尤其按钮、筛选条、表单项这种复用组件,名字不清楚,复用越多越难改。我建议组件参数尽量表达“业务角色”,而不是表达“数据形态”。例如按钮组件里,label比text更接近按钮语义,比desc更明确,onSubmit比callback更可维护。好的参数名应该让调用代码自己解释自己,而不是靠注释补救。

2026-08-04 09:38:15 241

原创 HarmonyOS7 ForEach key 写错会有怪问题:ArkUI/ArkTS 实战拆解

ForEach的 key 很容易被低估。页面能显示出来,不代表 key 写对了。评论列表、消息列表、任务列表这类会插入、删除、置顶的数据,如果 key 用数组下标,刷新时可能出现内容复用错位、局部状态串行、动画表现异常等问题。在 HarmonyOS7 的 ArkUI 里,我会把 key 当成列表项的身份证。它必须稳定、唯一,并且来自业务数据本身。数组位置不是身份,因为位置随时会变。只要列表会增删改排,key 就不要用 index。

2026-08-03 09:31:36 166

原创 HarmonyOS7 数组更新要触发 UI 变化:ArkUI/ArkTS 实战拆解

购物车页面最常见的问题之一,是“数据明明改了,界面怎么没按预期刷新”。在 HarmonyOS7 的 ArkUI 里,数组作为@State时,我更建议用重新赋值的方式表达变化:新增就生成新数组,删除就filter,修改数量就map后赋回去。这样意图清楚,也更容易触发 UI 更新。直接改数组内部对象有时看起来省事,但维护成本高。尤其购物车这种有数量、选中、合计金额的页面,一旦刷新不稳定,用户会直接怀疑金额算错。对 UI 状态来说,“我改了某个对象属性”不如“我得到了一份新的数组状态”可靠。

2026-08-03 09:31:21 208

原创 HarmonyOS7 可空类型要早处理:ArkUI/ArkTS 实战拆解

可空类型不是麻烦,它是在提醒你:这个值确实可能不存在。在 HarmonyOS7 的 ArkTS 页面里,如果把null一路传到 UI 深处,最后就会出现到处if、到处兜底的代码。详情页尤其典型,接口还没回来时对象为空,字段缺失时也为空,错误时还是空,如果不早点收敛,build()会被判断淹没。我更喜欢在数据进入页面状态前就处理可空值:要么给出默认 UI 模型,要么明确进入空态或错误态。这样 ArkUI 渲染时面对的是确定结构,而不是一堆可能为null的字段。可空值越早处理,UI 越干净;

2026-08-03 09:31:01 214

空空如也

空空如也

TA创建的收藏夹 TA关注的收藏夹

TA关注的人

提示
确定要删除当前文章?
取消 删除