Vue / 系统课时

搭建后台基础布局

搭建后台基础布局

本课会搭出管理后台最基本的应用外壳:左侧导航固定、顶部栏固定,只有内容区独立滚动。完成后,页面结构不会因业务内容变长而整体错位,并能为后续路由页面提供稳定的承载区域。

学习目标

  • 划分侧边栏、顶部栏与主内容区的职责
  • 使用 CSS Grid 和 Flex 控制固定尺寸与自适应区域
  • 验证内容区滚动、视口高度和溢出行为

先确定布局边界

后台布局最容易出错的地方不是颜色和间距,而是“谁负责占满视口、谁允许滚动”。根容器应固定为视口高度,侧边栏跨越整行,右侧区域再分成顶部栏和内容区;主内容区必须显式允许收缩,否则长内容会把整个页面撑高。

后台基础布局的固定区与滚动区

编写布局组件

下面的组件只依赖 Vue 3,不依赖 UI 组件库。min-width: 0 和 min-height: 0 是关键设置,它们允许 Grid 与 Flex 子项正确收缩,避免内容把容器撑出视口。

vue
<!-- src/layouts/AdminLayout.vue -->
<script setup lang="ts">
const menus = ['控制台', '用户管理', '系统设置']
</script>

<template>
  <div class="admin-layout">
    <aside class="sidebar">
      <div class="brand">Vue Admin</div>
      <nav class="menu">
        <a v-for="item in menus" :key="item" href="#">{{ item }}</a>
      </nav>
    </aside>

    <section class="workspace">
      <header class="header">
        <span>管理后台</span>
        <button type="button">退出登录</button>
      </header>

      <main class="main-scroll">
        <div class="content-card">
          <slot />
        </div>
      </main>
    </section>
  </div>
</template>

<style scoped>
:global(html),
:global(body),
:global(#app) {
  width: 100%;
  height: 100%;
  margin: 0;
}

* {
  box-sizing: border-box;
}

.admin-layout {
  /* 锁定视口,并让右侧列可以收缩而不是撑破页面 */
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  width: 100%;
  height: 100vh;
  overflow: hidden;
  background: #f4f6f8;
}

.sidebar {
  padding: 20px 16px;
  color: #fff;
  background: #1f2937;
}

.brand {
  margin-bottom: 24px;
  font-size: 20px;
  font-weight: 700;
}

.menu {
  display: grid;
  gap: 8px;
}

.menu a {
  padding: 10px 12px;
  color: #dbeafe;
  text-decoration: none;
  border-radius: 6px;
}

.menu a:hover {
  background: #374151;
}

.workspace {
  /* Grid 与 Flex 子项都要允许缩小 */
  display: flex;
  min-width: 0;
  min-height: 0;
  flex-direction: column;
}

.header {
  display: flex;
  flex: 0 0 56px;
  align-items: center;
  justify-content: space-between;
  padding: 0 20px;
  background: #fff;
  border-bottom: 1px solid #e5e7eb;
}

.main-scroll {
  /* 页面只在主内容区产生纵向滚动 */
  min-height: 0;
  padding: 20px;
  overflow: auto;
}

.content-card {
  min-height: 900px;
  padding: 20px;
  background: #fff;
  border-radius: 8px;
}
</style>

在入口页面中引入布局,并放入足够高的测试内容。这里的高度只用于验证滚动,接入真实业务页面后应删除测试样式。

vue
<!-- src/App.vue -->
<script setup lang="ts">
import AdminLayout from './layouts/AdminLayout.vue'
</script>

<template>
  <AdminLayout>
    <h2>控制台</h2>
    <p>向下滚动,观察侧边栏和顶部栏是否保持不动。</p>
  </AdminLayout>
</template>

运行并验证

启动开发服务器后,将浏览器窗口缩小并滚动主内容区。正确结果是页面本身不出现第二条纵向滚动条,侧边栏和顶部栏保持原位,只有白色内容区域滚动。

bash
npm run dev -- --host 127.0.0.1

预期输出

text
VITE ready in <TIME> ms

Local: http://127.0.0.1:<PORT>/

<TIME> 和 <PORT> 会随环境变化。打开终端显示的地址后,还应检查窗口宽度变小时右侧内容不会覆盖侧边栏。

常见布局问题

若整个页面一起滚动,先检查根容器是否设置 height: 100vh 和 overflow: hidden。若内容横向溢出,检查右侧 Grid 列是否使用 minmax(0, 1fr),以及 .workspace 是否设置 min-width: 0。若主内容区无法滚动,通常是上级 Flex 容器缺少 min-height: 0。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭建后台基础布局

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

登录哪都通