怎么实现 App 内全局 loading?请求时统一转圈?
阔敏ks 2026-11-04 22:49:35 harmonyos
每个页面请求都要自己写 loading 态,重复代码太多。想做一个全局的,发请求自动转,请求完自动关。
想问下鸿蒙怎么做这种全局 loading?在网络层拦截统一加?还是用全局状态管理?
您需要先 登录 才能评论/回答
全部评论(1)
全局 loading 要做成两半:状态在状态层,浮层在根布局。网络层只负责改状态,界面层只负责订阅状态,这样才不跟具体页面耦合。
状态用计数器而不是布尔值,这是关键。多个请求并发时,布尔值会出现"第一个请求结束就把 loading 关了"的尴尬,计数器等全部归零才收起来。
export class LoadingManager {
private static pending: number = 0;
static show(): void {
LoadingManager.pending++;
AppStorage.setOrCreate('globalLoading', true);
}
static hide(): void {
LoadingManager.pending--;
if (LoadingManager.pending <= 0) {
LoadingManager.pending = 0;
AppStorage.setOrCreate('globalLoading', false);
}
}
}
网络层封装里用 finally 包住,成功失败都要收,漏掉一次就会永久转圈:
import { http } from '@kit.NetworkKit';
async function requestData(url: string): Promise<string> {
LoadingManager.show();
try {
const req = new http.HttpRequest();
req.request(
url,
{
method: http.RequestMethod.GET,
expectDataType: http.HttpDataType.STRING
},
(err, data) => {
// 业务处理
}
);
return 'ok';
} finally {
LoadingManager.hide();
}
}
浮层放在根布局,不要每个页面各写一份。根组件订阅 AppStorage 的状态,在 Navigation 外层叠一个覆盖层,所有子页面自动共享:
@Entry
@Component
struct AppRoot {
@StorageProp('globalLoading') isLoading: boolean = false;
build() {
Stack() {
Navigation() {
// 业务页面都在这里
}
.mode(NavigationMode.Stack)
if (this.isLoading) {
Column({ space: 8 }) {
LoadingProgress()
.width(40)
.height(40)
Text('加载中')
.fontSize(13)
.fontColor(Color.White)
}
.width(110)
.height(110)
.justifyContent(FlexAlign.Center)
.backgroundColor('#B3000000')
.borderRadius(12)
}
}
.width('100%')
.height('100%')
.hitTestBehavior(HitTestMode.Block)
}
}
再用下去会发现两个问题,提前给方案。一是闪烁:接口很快(一两百毫秒)的时候转圈一闪而过,观感很廉价,加个延迟显示,超过 300 毫秒才出现,小于这个时长就干脆不显示。二是所有请求都全球转圈也不对——列表下拉刷新、静默上报这些不该弹浮层,所以在封装上留个开关参数,默认弹,明确标记为静默的请求跳过。
还有一点,浮层要能挡住点击,不然用户在转圈时还能连点按钮,容易重复提交。上面那个 hitTestBehavior 就是干这个的。真正阻塞式的加载建议配合按钮自身的 disable,双保险。
最后说一句取舍:全局浮层适合"跳转、提交"这类明确阻塞的动作;列表加载建议用页面内的骨架屏,别用全局转圈,否则用户会觉得整个 App 卡住了。两种可以共存,按场景选。
2026-11-17 09:07:43