Vue / 系统课时

适配响应式布局

适配响应式布局

管理后台在窄屏下最常见的问题是侧栏挤压内容、卡片横向溢出以及图表尺寸不更新。本课将用明确断点、弹性网格和容器监听,让常用页面在不同视口宽度下保持可读与可操作。

学习目标

  • 为侧栏、内容网格和移动端抽屉定义清晰断点
  • 使用 CSS Grid 构建可收缩且不溢出的页面结构
  • 让 ECharts 在容器尺寸变化时自动重绘

先定义布局断点

响应式布局应先确定行为,再编写样式。桌面端保留完整侧栏和三列卡片;中等宽度将侧栏压缩为图标栏,并把卡片改为两列;手机端隐藏侧栏,通过按钮打开抽屉,内容改为单列。

管理后台在桌面、平板和手机宽度下的布局变化

断点不必追求设备型号覆盖,而应以布局开始拥挤的位置为准。示例采用 1200px 和 768px 两个边界,项目中可根据侧栏宽度、卡片最小宽度和实际内容重新测量。

实现侧栏与内容网格

下面的组件可直接作为布局骨架使用。关键点是主内容列使用 minmax(0, 1fr),内容区和卡片同时设置 min-width: 0,否则长表格或图表可能撑破网格。

vue
<script setup lang='ts'>
import { onBeforeUnmount, onMounted, ref } from 'vue'

const isMobile = ref(false)
const drawerOpen = ref(false)
let media: MediaQueryList | undefined

function syncViewport() {
  if (!media) return

  // 逻辑断点与 CSS 断点保持一致,避免两套状态不同步
  isMobile.value = media.matches

  // 回到非手机宽度时关闭残留的移动端抽屉状态
  if (!media.matches) {
    drawerOpen.value = false
  }
}

onMounted(() => {
  media = window.matchMedia('(max-width: 767px)')
  syncViewport()
  media.addEventListener('change', syncViewport)
})

onBeforeUnmount(() => {
  media?.removeEventListener('change', syncViewport)
})
</script>

<template>
  <!-- 桌面端侧栏常驻,手机端仅在抽屉打开时渲染 -->
  <div class='admin-shell'>
    <aside v-if='!isMobile || drawerOpen' class='sidebar'>
      <strong>后台菜单</strong>
    </aside>

    <header class='topbar'>
      <button v-if='isMobile' type='button' @click='drawerOpen = !drawerOpen'>
        菜单
      </button>
      <span>数据看板</span>
    </header>

    <main class='content'>
      <section class='dashboard-grid'>
        <article v-for='item in 4' :key='item' class='card'>
          卡片 {{ item }}
        </article>
      </section>
    </main>
  </div>
</template>

<style scoped>
.admin-shell {
  /* 主内容列允许收缩,避免宽表格或图表撑破页面 */
  min-height: 100vh;
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  grid-template-rows: 56px 1fr;
}

.sidebar {
  grid-row: 1 / span 2;
  padding: 20px;
  border-right: 1px solid #e5e7eb;
  background: #ffffff;
  overflow: hidden;
}

.topbar {
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 0 20px;
  border-bottom: 1px solid #e5e7eb;
}

.content {
  min-width: 0;
  padding: 20px;
}

.dashboard-grid {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 16px;
}

.card {
  min-width: 0;
  min-height: 160px;
  padding: 16px;
  border: 1px solid #e5e7eb;
  border-radius: 8px;
  background: #ffffff;
}

@media (max-width: 1199px) and (min-width: 768px) {
  .admin-shell {
    grid-template-columns: 72px minmax(0, 1fr);
  }

  .dashboard-grid {
    grid-template-columns: repeat(2, minmax(0, 1fr));
  }
}

@media (max-width: 767px) {
  .admin-shell {
    display: block;
  }

  .sidebar {
    position: fixed;
    inset: 0 auto 0 0;
    z-index: 20;
    width: 220px;
    box-sizing: border-box;
  }

  .topbar {
    height: 56px;
    padding: 0 12px;
  }

  .content {
    padding: 12px;
  }

  .dashboard-grid {
    grid-template-columns: 1fr;
  }
}
</style>

预期结果

text
视口宽度不小于 1200px:侧栏宽 220px,卡片显示三列。
视口宽度为 768px~1199px:侧栏缩为 72px,卡片显示两列。
视口宽度小于 768px:侧栏默认隐藏,点击“菜单”后以抽屉形式出现,卡片显示单列。

让图表跟随容器变化

只监听 window.resize 不够,因为侧栏折叠、标签页切换或父级网格变化也会改变图表容器宽度。应使用 ResizeObserver 观察图表节点,并在尺寸变化时调用 chart.resize()。

以下是片段示例,需放入已经创建 chart 和 chartRef 的 ECharts 组件中。

ts
// 观察真实容器尺寸,覆盖侧栏折叠和父级网格变化
const resizeObserver = new ResizeObserver(() => {
  chart?.resize()
})

onMounted(() => {
  if (chartRef.value) {
    resizeObserver.observe(chartRef.value)
  }
})

onBeforeUnmount(() => {
  resizeObserver.disconnect()
})

预期结果

text
拖动浏览器宽度、折叠侧栏或改变父级网格后,图表会按容器重新计算宽高,不出现裁切、留白或横向溢出。

验收不同宽度

至少在 1440px、1024px 和 375px 三个宽度下检查页面。确认页面没有横向滚动条,主要操作按钮仍可见,侧栏可以打开和关闭,卡片内容不会互相覆盖,图表图例与提示框也没有被裁切。

常见错误包括给卡片写死宽度、忘记为网格子项设置 min-width: 0、只根据设备名称选择断点,以及组件卸载后没有移除媒体查询和尺寸监听。修复后应再次执行三档宽度验收。

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

目录与阅读设置

阅读设置

17

记录一个想法

适配响应式布局

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

登录哪都通