游戏客户端架构 / 系统课时
异步数据回来前界面显示什么
异步数据回来前界面显示什么
玩家打开背包、任务列表或排行榜时,数据往往还在路上。界面如果只靠“有没有数据”判断,很容易把加载中误显示为空,把失败误显示成暂无内容。本节用四态 UI 状态机,让每个时刻都有明确反馈,并避免旧内容与新状态互相打架。
学习目标
- 区分加载中、空数据、成功和失败四种界面状态
- 用单一状态驱动可见区域,避免多个布尔值组合出非法界面
- 处理首次加载与已有内容刷新时的显示差异
先把“没有内容”拆成不同原因
异步请求尚未返回时,items.length === 0 并不能说明“确实没有数据”。它可能代表请求未开始、正在加载、请求失败,或者服务器成功返回空集合。若这些情况共用同一个空白面板,玩家无法判断应该等待、重试还是离开。
一个最小可用模型通常包含四种状态:
| 状态 | 进入条件 | 主要显示 |
|---|---|---|
loading |
首次请求已发出但未完成 | 加载提示或骨架占位 |
empty |
请求成功且结果为空 | 空状态说明与下一步入口 |
success |
请求成功且有可展示数据 | 正常内容 |
error |
请求失败且当前没有可用内容 | 错误说明与重试操作 |
用一个状态决定界面,而不是堆布尔值
如果同时维护 isLoading、hasError、isEmpty、hasData,很容易出现“既在加载又显示错误”之类的非法组合。更稳妥的做法是让界面一次只处于一个主状态,并由状态决定哪些区域可见。

下面的示例把状态收敛为单一枚举,并让渲染函数只处理当前状态:
const UiState = Object.freeze({
LOADING: "loading",
EMPTY: "empty",
SUCCESS: "success",
ERROR: "error",
});
function render(state, items = []) {
switch (state) {
case UiState.LOADING:
return "显示加载占位";
case UiState.EMPTY:
return "显示空状态:暂无可领取任务";
case UiState.SUCCESS:
return `显示 ${items.length} 条任务`;
case UiState.ERROR:
return "显示加载失败与重试按钮";
default:
throw new Error(`未知 UI 状态: ${state}`);
}
}
console.log(render(UiState.LOADING));
console.log(render(UiState.EMPTY));
console.log(render(UiState.SUCCESS, ["daily", "weekly"]));
console.log(render(UiState.ERROR));预期输出:
显示加载占位
显示空状态:暂无可领取任务
显示 2 条任务
显示加载失败与重试按钮这样做的关键不是枚举本身,而是建立约束:请求完成前不能进入 empty,请求失败不能进入 success,只有成功结果为空时才能进入 empty。
首次加载和刷新不要使用同一视觉策略
首次进入界面时没有旧内容可用,使用全屏加载占位通常合理。但玩家已经看到一页背包内容后点击刷新,如果立刻把内容全部清空并切回全屏 loading,界面会产生明显闪烁,还会让玩家失去当前上下文。
更合适的处理是保留已有内容,同时增加一个独立的“正在刷新”提示。主内容仍按 success 展示,只有刷新失败时再决定是保留旧数据并给轻量错误提示,还是在数据已不可用时进入完整 error 状态。
状态切换必须由请求结果驱动
界面打开后先进入 loading,请求成功时根据结果长度进入 empty 或 success,请求失败则进入 error。重试只负责重新发起请求并回到加载过程,不要在点击重试时提前假设会成功。
这种状态机特别适合背包、任务、排行榜、商店列表等依赖异步数据的界面。它让“现在显示什么”从零散条件判断变成可验证的状态转换,也为后续加入取消请求、缓存和刷新策略留下稳定入口。