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。
按自己的节奏,确认真正理解。