第 16 天|网络四态:loading、error、empty、content

本篇看点
  • 阅读目标:用明确状态模型表达 loading、error、empty、content,减少散乱 boolean。
  • 核心问题:网络页面先建状态模型,再渲染 UI,而不是请求成功后直接塞数组。
  • 对比迁移:对应 Flutter AsyncValue/Bloc State 和 iOS ViewState/Result。
前言
网络列表不是"请求成功后展示数组"这么简单。真实页面至少有四态:loading、error、empty、content。少任何一个,用户体验都会不完整。
Flutter 里你可能会用 AsyncSnapshot、Bloc state、Riverpod 的 AsyncValue。iOS 里你可能会建 ViewState 或 Result。HarmonyOS 里也应该先建状态模型,再写 UI。
一. 先定义页面状态
页面里堆几个布尔值时,很快会出现状态组合问题:
ts 复制代码
@State loading: boolean = false;
@State failed: boolean = false;
@State empty: boolean = false;
这种写法很容易出现互相矛盾:loading 和 failed 同时为 true,或者 items 有数据但 empty 还是 true。
更好的方式是用状态对象:
ts 复制代码
enum LoadStatus {
  Loading,
  Success,
  Empty,
  Failure
}

interface PageLoadState<T> {
  status: LoadStatus;
  data?: T;
  message?: string;
}
页面只根据 status 渲染:
ts 复制代码
if (this.state.status === LoadStatus.Loading) {
  LoadingView()
} else if (this.state.status === LoadStatus.Failure) {
  ErrorView({ message: this.state.message })
} else if (this.state.status === LoadStatus.Empty) {
  EmptyView()
} else {
  ContentList({ items: this.state.data ?? [] })
}
二. Repository 返回 Result,而不是直接抛给页面
网络请求失败可能来自很多地方:无网、超时、服务端错误、解析失败、业务错误码。页面更适合消费整理后的错误状态,而不是直接理解所有底层细节。
ts 复制代码
interface Result<T> {
  success: boolean;
  data?: T;
  message?: string;
  code?: string;
}
Repository 负责把底层错误统一成业务可理解的结果:
ts 复制代码
async loadArticles(): Promise<Result<Article[]>> {
  try {
    const response = await this.http.get<Article[]>('/articles');
    return { success: true, data: response };
  } catch (error) {
    return { success: false, message: '网络请求失败,请稍后重试' };
  }
}
这和 iOS 的 Result<T, Error>、Flutter 里的 Either/Result 是同一类工程习惯。
三. loading 分两种
首屏 loading 和局部 loading 可以分开建模。
首屏没有内容时,可以展示骨架屏或空白 loading。已有内容时刷新,更适合保留内容并展示局部刷新状态,否则体验会闪。
ts 复制代码
interface ListState<T> {
  items: T[];
  initialLoading: boolean;
  refreshing: boolean;
  loadingMore: boolean;
  errorMessage?: string;
}
资讯列表、发现分页、排行榜切 Tab,都可以用这种状态结构。
四. error 也要分层
错误页不是只有一个"请求失败"。至少分:
  1. 首屏失败:页面没有内容,需要占位和重试。
  2. 刷新失败:保留旧内容,提示刷新失败。
  3. 加载更多失败:底部显示重试,不影响已有列表。
  4. 详情失败:详情页展示错误和返回能力。
Flutter 中也常这样拆,比如 status == initialFailure 和 status == loadMoreFailure;iOS 里会区分 empty view、toast、footer retry。
五. 为什么这件事适合做成练习
初学网络时,如果只写一个 fetch(),学习者会误以为网络就是 API 调用。真正有价值的练习,是让读者看到状态如何驱动 UI。
在练习页面里,网络列表可以模拟慢请求、失败、空数据、重试。到了真实 App,同样模型可以迁移到资讯列表、专辑详情和发现页分页。
六. 实践经验
第一,用多个 boolean 管页面状态,状态组合失控。
第二,首屏 loading 和刷新 loading 用同一种遮罩,页面一直闪。
第三,网络错误直接展示底层异常,用户看不懂。
第四,Repository 把 UI 文案写死,导致不同页面无法定制错误展示。
小结
网络请求的第一课不是 GET/POST,而是四态建模。只要状态设计清楚,UI、重试、缓存、分页都会顺很多。
下一篇我们继续网络列表,重点讲下拉刷新、上拉加载、竞态保护和分页边界。
今日练习
  1. 把一个网络页面改成 Loading/Success/Empty/Failure 四态。
  2. 让首屏失败展示错误页,刷新失败只提示,不清空旧内容。
  3. 给 Repository 返回统一 Result<T>,页面不直接处理底层异常。
相关推荐
huang_xiaoen9 小时前
鸿蒙手机远程控制电脑哪个好用?2026鸿蒙远控软件横测推荐
华为·harmonyos·远程工作·远程工具·远程办公
爱写Bug的浮游2 天前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
程序猿追2 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos2 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji3 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207413 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白3 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方3 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追3 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追3 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos