React / 系统课时

设计骨架与空状态

设计骨架与空状态

页面在请求未完成、数据为空或用户第一次进入时,不能只留下一块空白。本节会把这三类状态拆开处理,并用可复用组件建立稳定的反馈规则,让用户始终知道页面正在做什么、为什么没有内容,以及下一步可以做什么。

学习目标

  • 区分加载骨架、空状态与首次使用引导的职责
  • 在 Next.js 页面中实现可复用的状态反馈组件
  • 用可操作文案和布局稳定性检查反馈质量

先区分三种状态

加载中表示“内容还没回来”,适合使用与最终布局相近的骨架,减少页面突然跳动。空状态表示“请求已经完成,但结果为空”,此时要解释原因并给出刷新、创建或调整筛选条件等动作。首次使用则更偏向引导,应该告诉用户这个功能能做什么,并给出最短的第一步。

加载骨架、空状态与首次使用三种页面状态对比

设计可复用状态组件

下面的文件示例适用于 Next.js App Router。把组件保存为 app/ui/ContentState.tsx,用一个联合类型限制每种状态允许出现的字段,并让空状态操作使用真实链接而不是无行为按钮。

tsx
import Link from "next/link";

type ContentStateProps =
  | { kind: "loading"; message?: string }
  | { kind: "empty"; message: string; actionLabel?: string; actionHref?: string }
  | { kind: "first-use"; message: string; actionLabel: string; actionHref: string };

const skeletonStyle = {
  height: 72,
  marginBottom: 12,
  borderRadius: 12,
  background: "#e5e7eb",
};

export function ContentState(props: ContentStateProps) {
  // 加载阶段只表达“仍在等待”,避免提前宣告没有数据。
  if (props.kind === "loading") {
    return (
      <section aria-busy="true" aria-label={props.message ?? "内容加载中"}>
        <div style={skeletonStyle} />
        <div style={skeletonStyle} />
        <div style={skeletonStyle} />
      </section>
    );
  }

  // 请求结束后,再根据用户历史区分普通空状态与首次使用。
  return (
    <section aria-live="polite">
      <h2>{props.kind === "empty" ? "暂时没有内容" : "开始创建第一条内容"}</h2>
      <p>{props.message}</p>
      {props.actionLabel && props.actionHref ? (
        <Link href={props.actionHref}>{props.actionLabel}</Link>
      ) : null}
    </section>
  );
}

预期结果:kind="loading" 时显示三块可见骨架;请求结束后显示解释文案,并且只有提供了目标地址时才出现可执行操作。

aria-busy 能向辅助技术表达区域仍在更新,aria-live 则适合让已完成请求后的状态变化被感知。实际项目可以把骨架样式迁入 CSS Modules,并按设计系统统一尺寸和颜色。

接入页面状态

页面判断顺序要避免互相覆盖:先判断请求是否仍在进行,再判断是否属于首次使用,最后判断普通空结果。这样不会在请求尚未结束时提前显示“没有数据”。

tsx
import { ContentState } from "./ui/ContentState";

type Item = { id: string; name: string };

export default function ExamplePage() {
  // 真实项目中,这三个值通常来自请求状态、用户历史与接口结果。
  const loading = false;
  const hasCreatedBefore = true;
  const items: Item[] = [];

  if (loading) {
    return <ContentState kind="loading" message="正在加载项目" />;
  }

  if (!hasCreatedBefore) {
    return (
      <ContentState
        kind="first-use"
        message="创建第一条项目后,这里会展示你的内容。"
        actionLabel="创建项目"
        actionHref="/projects/new"
      />
    );
  }

  // 只有请求结束且用户并非首次使用时,才进入普通空状态。
  if (items.length === 0) {
    return (
      <ContentState
        kind="empty"
        message="当前筛选条件下没有项目,可以清除筛选后重试。"
        actionLabel="清除筛选"
        actionHref="/projects"
      />
    );
  }

  return <ul>{items.map((item) => <li key={item.id}>{item.name}</li>)}</ul>;
}

预期结果:示例中的 loading 为 false、hasCreatedBefore 为 true 且 items 为空,因此页面显示普通空状态,并提供指向 /projects 的“清除筛选”链接。

验收反馈质量

检查时先观察页面结构是否稳定,再看文案是否解释清楚原因与下一步。加载状态不要出现误导性的“无数据”,空状态不要只写“暂无内容”,首次使用也不要一次塞入过多教程。对真正的异步请求,还应确保失败状态单独处理,避免把网络错误伪装成空结果。

状态设计的目标不是让页面“看起来不空”,而是让用户在任何阶段都能判断当前发生了什么,并知道是否需要等待、调整条件或立即执行下一步。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计骨架与空状态

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

登录哪都通