游戏客户端架构 / 系统课时

异步数据回来前界面显示什么

异步数据回来前界面显示什么

玩家打开背包、任务列表或排行榜时,数据往往还在路上。界面如果只靠“有没有数据”判断,很容易把加载中误显示为空,把失败误显示成暂无内容。本节用四态 UI 状态机,让每个时刻都有明确反馈,并避免旧内容与新状态互相打架。

学习目标

  • 区分加载中、空数据、成功和失败四种界面状态
  • 用单一状态驱动可见区域,避免多个布尔值组合出非法界面
  • 处理首次加载与已有内容刷新时的显示差异

先把“没有内容”拆成不同原因

异步请求尚未返回时,items.length === 0 并不能说明“确实没有数据”。它可能代表请求未开始、正在加载、请求失败,或者服务器成功返回空集合。若这些情况共用同一个空白面板,玩家无法判断应该等待、重试还是离开。

一个最小可用模型通常包含四种状态:

状态 进入条件 主要显示
loading 首次请求已发出但未完成 加载提示或骨架占位
empty 请求成功且结果为空 空状态说明与下一步入口
success 请求成功且有可展示数据 正常内容
error 请求失败且当前没有可用内容 错误说明与重试操作

用一个状态决定界面,而不是堆布尔值

如果同时维护 isLoading、hasError、isEmpty、hasData,很容易出现“既在加载又显示错误”之类的非法组合。更稳妥的做法是让界面一次只处于一个主状态,并由状态决定哪些区域可见。

异步界面四态状态图

下面的示例把状态收敛为单一枚举,并让渲染函数只处理当前状态:

js
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));

预期输出:

text
显示加载占位
显示空状态:暂无可领取任务
显示 2 条任务
显示加载失败与重试按钮

这样做的关键不是枚举本身,而是建立约束:请求完成前不能进入 empty,请求失败不能进入 success,只有成功结果为空时才能进入 empty。

首次加载和刷新不要使用同一视觉策略

首次进入界面时没有旧内容可用,使用全屏加载占位通常合理。但玩家已经看到一页背包内容后点击刷新,如果立刻把内容全部清空并切回全屏 loading,界面会产生明显闪烁,还会让玩家失去当前上下文。

更合适的处理是保留已有内容,同时增加一个独立的“正在刷新”提示。主内容仍按 success 展示,只有刷新失败时再决定是保留旧数据并给轻量错误提示,还是在数据已不可用时进入完整 error 状态。

状态切换必须由请求结果驱动

界面打开后先进入 loading,请求成功时根据结果长度进入 empty 或 success,请求失败则进入 error。重试只负责重新发起请求并回到加载过程,不要在点击重试时提前假设会成功。

这种状态机特别适合背包、任务、排行榜、商店列表等依赖异步数据的界面。它让“现在显示什么”从零散条件判断变成可验证的状态转换,也为后续加入取消请求、缓存和刷新策略留下稳定入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

异步数据回来前界面显示什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通