ArkUI 组件复用与自定义组件生命周期:aboutToAppear 之后发生了什么
aboutToAppear 在组件生命周期里只执行一次,即使这个组件被复用了一百次。所有"复用后数据串了""图片显示了上一行的"的 bug,根因都在这个认知偏差上。复用的入口是 aboutToReuse,不是 aboutToAppear。
一、先把顺序理清楚:aboutToAppear 之后是 build,不是渲染完成
自定义组件的生命周期比想象中短。aboutToAppear 在创建组件实例、初始化成员变量之后、build 之前被调用。此时可以访问 this 上的状态,但还没有任何 UI 节点被创建。
紧接着是 build。这个函数必须是纯的:只描述 UI,不能改状态、不能发请求、不能打印副作用日志。在 build 里改 @State 会触发一次额外渲染,轻则掉帧,重则形成循环。我见过在 build 里调 this.count++ 的代码,页面直接卡死。
build 之后是布局与绘制。这时才有真实的节点和尺寸,所以任何需要测量结果的操作(比如计算文本高度、滚动到指定位置)都必须放到 onAppear 或者 onAreaChange 里,不能在 aboutToAppear 里做。
页面级还有两个回调:onPageShow 和 onPageHide,只在 @Entry 组件上生效,且在页面可见性变化时触发。从二级页返回时会再次触发 onPageShow,但不会重新触发 aboutToAppear。这个差异是"返回后数据没刷新"的常见原因。
二、复用改变了一切:aboutToAppear 不再执行
给组件加上 @Reusable 之后,它会被放进复用池。列表滚动时,移出屏幕的组件不是被销毁,而是被回收;新进入屏幕的项不是新建,而是从池子里取一个复用。
关键在于:复用取出的组件,aboutToAppear 不会再次执行,aboutToDisappear 也不会在回收时执行。取而代之的是 aboutToRecycle(回收)和 aboutToReuse(params)(复用)。
所以任何"一次性初始化"的代码放在 aboutToAppear 里,复用时就会保留上一个数据的痕迹。最典型的症状是:列表快速滚动后,某几行的头像或文字变成了别行的内容。
正确做法是把"与数据无关的初始化"留在 aboutToAppear,把"与数据绑定的状态重置"放进 aboutToReuse。
@Reusable
@Component
struct OrderItem {
@State orderNo: string = '';
@State amount: string = '';
@State status: string = '待支付';
private pressed: boolean = false; // 非状态成员也要重置
aboutToAppear(): void {
// 只做与数据无关的事:注册监听、初始化动画控制器
console.info('OrderItem created');
}
// 复用时被调用,params 是父组件传进来的新值
aboutToReuse(params: Record<string, Object>): void {
this.orderNo = params['orderNo'] as string;
this.amount = params['amount'] as string;
this.status = params['status'] as string;
this.pressed = false; // 交互态必须手动清
}
aboutToRecycle(): void {
// 回收前释放这个项持有的资源,比如取消图片请求
this.pressed = false;
}
build() {
Row() {
Text(this.orderNo).fontSize(16)
Blank()
Text(`¥${this.amount}`).fontSize(16)
Text(this.status).fontSize(14).fontColor('#999')
}
.width('100%')
.padding({ left: 16, right: 16, top: 12, bottom: 12 })
}
}
注意 pressed 这类普通成员不会被框架重置。如果它控制着背景色,复用后就会出现"没点过的项显示按下态"。这类问题在快照和日志里都看不出来,只能靠代码审查。
三、@Reusable 的三个约束
第一个约束:reuseId 决定复用池的归属。默认同一个组件类型共用一个池子。如果一个组件在不同位置有不同结构(比如列表项和网格项共用一个 struct),必须实现 reuseId() 返回不同标识,否则会把列表布局复用成网格布局,出现尺寸错乱。
第二个约束:params 的键必须稳定。aboutToReuse 收到的是父组件这次传入的参数集合,如果某次少传了一个键,取出来就是 undefined,赋值给 @State 会直接变成空字符串或崩溃。
第三个约束:复用不跨组件类型。@Reusable 只对同类型组件生效,不要指望列表项复用到另一个列表。跨列表复用需要同一个 reuseId 且在同一棵组件树下。
四、LazyForEach 与 cachedCount 决定复用频率
LazyForEach 配合 IDataSource 才有真正的按需创建。cachedCount 控制列表在可视区外额外缓存多少个项,默认值偏小,快速滚动时会出现白块。我把 cachedCount 设为可视区数量的一半,比如一屏 8 项就设 4。
但 cachedCount 调大不等于性能更好。缓存项也占用内存和复用池槽位,设成 20 在低端机上会明显增加内存峰值。我的经验值是 3 到 6 之间,列表项越复杂取越小。
还有一个细节:keyGenerator 必须返回稳定且唯一的 key。用索引当 key 是最常见的错误——数据插入后,key 与实际内容错位,复用组件拿到的是错行的数据,表现出来就是"删了一条,下面全串了"。
| 回调 | 触发时机 | 复用时是否触发 | 适合做的事 |
|---|---|---|---|
| aboutToAppear | 实例创建后、build 前 | 否 | 注册监听、初始化控制器 |
| build | 每次渲染 | 是 | 只描述 UI |
| onPageShow | 页面可见 | 是(页面级) | 刷新可见数据 |
| aboutToReuse | 从复用池取出 | 是 | 重置全部数据绑定状态 |
| aboutToRecycle | 放回复用池 | 是 | 释放项级资源 |
| aboutToDisappear | 实例销毁 | 否(复用不销毁) | 注销监听、清定时器 |
五、自检清单
- 加了
@Reusable的组件,检查所有@State是否都在aboutToReuse里被重新赋值。 - 普通成员变量(布尔标记、计数器)也要在复用时重置。
- 多布局场景实现
reuseId(),避免跨结构复用。 LazyForEach的 key 用业务 id,不用索引。cachedCount控制在 3 到 6,按列表项复杂度调整。- 在
onPageShow里刷新数据,不要依赖aboutToAppear。 - 用"快速滚动 10 秒再回顶"的方式做回归,复用问题几乎都能暴露。
- 点赞
- 收藏
- 关注作者
评论(0)