React / 系统课时
设计骨架与空状态
设计骨架与空状态
页面在请求未完成、数据为空或用户第一次进入时,不能只留下一块空白。本节会把这三类状态拆开处理,并用可复用组件建立稳定的反馈规则,让用户始终知道页面正在做什么、为什么没有内容,以及下一步可以做什么。
学习目标
- 区分加载骨架、空状态与首次使用引导的职责
- 在 Next.js 页面中实现可复用的状态反馈组件
- 用可操作文案和布局稳定性检查反馈质量
先区分三种状态
加载中表示“内容还没回来”,适合使用与最终布局相近的骨架,减少页面突然跳动。空状态表示“请求已经完成,但结果为空”,此时要解释原因并给出刷新、创建或调整筛选条件等动作。首次使用则更偏向引导,应该告诉用户这个功能能做什么,并给出最短的第一步。

设计可复用状态组件
下面的文件示例适用于 Next.js App Router。把组件保存为 app/ui/ContentState.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,并按设计系统统一尺寸和颜色。
接入页面状态
页面判断顺序要避免互相覆盖:先判断请求是否仍在进行,再判断是否属于首次使用,最后判断普通空结果。这样不会在请求尚未结束时提前显示“没有数据”。
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 的“清除筛选”链接。
验收反馈质量
检查时先观察页面结构是否稳定,再看文案是否解释清楚原因与下一步。加载状态不要出现误导性的“无数据”,空状态不要只写“暂无内容”,首次使用也不要一次塞入过多教程。对真正的异步请求,还应确保失败状态单独处理,避免把网络错误伪装成空结果。
状态设计的目标不是让页面“看起来不空”,而是让用户在任何阶段都能判断当前发生了什么,并知道是否需要等待、调整条件或立即执行下一步。