HTML / CSS / 系统课时

搭建后台页面骨架

搭建后台页面骨架

本课把规划稿实现为一个可运行的 React 与 Tailwind 页面:桌面端显示固定侧边栏,窄屏通过按钮打开抽屉导航,顶部栏保持可见,主内容自动为侧边栏留出空间。完成后,你将拥有可继续填充卡片、表格和业务模块的稳定骨架。

学习目标

  • 使用固定定位和内容留位构建后台三段式布局。
  • 通过响应式类实现桌面侧边栏与移动抽屉切换。
  • 验证层级、滚动、键盘焦点和内容遮挡问题。

先确定布局层级

后台页面骨架的定位、层级与响应式关系图

页面根节点负责全局背景与最小高度;侧边栏使用 fixed 脱离普通文档流,因此桌面内容容器必须通过 lg:pl-64 主动留位。顶部栏放在内容容器内部并使用 sticky top-0,这样页面滚动时标题和操作仍然可见。

移动端抽屉需要两层覆盖元素:z-40 的半透明遮罩负责阻止用户误触主内容,z-50 的侧边栏位于遮罩上方。桌面端通过 lg:translate-x-0 取消抽屉位移,并用 lg:hidden 移除遮罩和菜单按钮。

实现可交互骨架

下面是完整的 src/App.tsx。示例依赖已经能够编译 React 与 Tailwind CSS 的项目,不依赖图标库;导航数据、统计卡片和移动端开关都包含在同一组件中。

tsx
import { useState } from "react";

const navigation = ["总览", "订单", "客户", "设置"];
const stats = [
  { label: "今日订单", value: "128" },
  { label: "待处理", value: "17" },
  { label: "本月收入", value: "¥86,400" }
];

export default function App() {
  const [sidebarOpen, setSidebarOpen] = useState(false);

  return (
    <div className="min-h-screen bg-slate-50 text-slate-900">
      {sidebarOpen && (
        <button
          type="button"
          aria-label="关闭导航"
          className="fixed inset-0 z-40 bg-slate-950/40 lg:hidden"
          onClick={() => setSidebarOpen(false)}
        />
      )}

      <aside
        className={`fixed inset-y-0 left-0 z-50 w-64 border-r border-slate-200 bg-white p-5 transition-transform lg:translate-x-0 ${
          sidebarOpen ? "translate-x-0" : "-translate-x-full"
        }`}
      >
        <div className="mb-8 flex items-center justify-between">
          <span className="text-lg font-semibold">管理后台</span>
          <button
            type="button"
            className="rounded-md px-2 py-1 text-sm hover:bg-slate-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500 lg:hidden"
            onClick={() => setSidebarOpen(false)}
          >
            关闭
          </button>
        </div>

        <nav aria-label="主导航" className="space-y-1">
          {navigation.map((item, index) => (
            <a
              key={item}
              href={`#${item}`}
              className={`block rounded-lg px-3 py-2 text-sm font-medium focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500 ${
                index === 0
                  ? "bg-sky-50 text-sky-700"
                  : "text-slate-600 hover:bg-slate-100 hover:text-slate-900"
              }`}
            >
              {item}
            </a>
          ))}
        </nav>
      </aside>

      <div className="lg:pl-64">
        <header className="sticky top-0 z-30 border-b border-slate-200 bg-white/95 backdrop-blur">
          <div className="flex h-16 items-center justify-between px-4 sm:px-6 lg:px-8">
            <div className="flex items-center gap-3">
              <button
                type="button"
                className="rounded-md border border-slate-300 px-3 py-2 text-sm hover:bg-slate-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500 lg:hidden"
                aria-expanded={sidebarOpen}
                onClick={() => setSidebarOpen(true)}
              >
                菜单
              </button>
              <h1 className="text-lg font-semibold">业务总览</h1>
            </div>
            <button
              type="button"
              className="rounded-lg bg-sky-600 px-4 py-2 text-sm font-semibold text-white hover:bg-sky-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-sky-500 focus-visible:ring-offset-2"
            >
              新建订单
            </button>
          </div>
        </header>

        <main className="mx-auto max-w-7xl p-4 sm:p-6 lg:p-8">
          <section
            aria-label="关键指标"
            className="grid gap-4 sm:grid-cols-2 xl:grid-cols-3"
          >
            {stats.map((stat) => (
              <article
                key={stat.label}
                className="rounded-xl border border-slate-200 bg-white p-5 shadow-sm"
              >
                <p className="text-sm text-slate-500">{stat.label}</p>
                <p className="mt-2 text-2xl font-bold">{stat.value}</p>
              </article>
            ))}
          </section>

          <section className="mt-6 rounded-xl border border-slate-200 bg-white p-5 shadow-sm">
            <h2 className="font-semibold">最近活动</h2>
            <p className="mt-2 text-sm leading-6 text-slate-600">
              这里可以继续接入表格、筛选器或业务列表。
            </p>
          </section>
        </main>
      </div>
    </div>
  );
}

在项目根目录运行:

bash
npm run dev

预期输出(终端格式可能略有差异):

text
VITE v<VERSION> ready in <TIME> ms
Local: http://localhost:<PORT>/

<VERSION>、<TIME> 和 <PORT> 会随本地环境变化。浏览器中应看到左侧导航、顶部栏、三张统计卡片和活动面板;缩窄视口后,侧边栏退出画面,点击“菜单”可打开抽屉,点击遮罩或“关闭”可收起。

检查响应式与可访问性

先在小于 lg 的视口测试抽屉,再扩大到桌面尺寸。打开抽屉时主内容应被遮罩覆盖但不发生横向位移;进入桌面断点后,遮罩消失,侧边栏固定显示,主内容左边缘与侧边栏右边缘对齐。

使用键盘按 Tab 逐个访问菜单按钮、导航链接和主要操作按钮。所有交互元素都应出现清晰焦点环;菜单按钮的 aria-expanded 会随抽屉状态变化,关闭按钮和遮罩均能结束当前导航操作。

处理常见布局故障

现象 根因 修复
主内容被侧边栏盖住 固定元素不占文档流 在内容容器添加与侧边栏等宽的 lg:pl-64
抽屉出现在遮罩下方 z-index 顺序错误 遮罩用 z-40,侧边栏用 z-50
桌面端仍能看到遮罩 只按状态渲染,未处理断点 为遮罩补充 lg:hidden
页面出现横向滚动 抽屉宽度或子元素溢出 检查固定宽度、长文本和负边距

最后检查页面在长内容下的滚动行为。侧边栏与顶部栏应保持定位,主内容独立向下延伸;若顶部栏被侧边栏覆盖,应重新检查两者的层级和内容容器是否正确留位。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建后台页面骨架

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

登录哪都通