Vue / 系统课时

接入趋势图表

接入趋势图表

趋势图表的难点不只是把数据画出来,还要保证组件更新和路由切换时不会重复创建实例。本课使用 ECharts 封装“初始化、更新、缩放、销毁”流程,让同一个图表实例随 Vue 组件生命周期稳定工作。

学习目标

  • 在 Vue 3 组件挂载后安全初始化图表实例
  • 使用 setOption 更新数据而不是重复执行初始化
  • 在尺寸变化和组件卸载时正确调用 resize 与 dispose

安装图表依赖

在项目根目录安装 ECharts,并用依赖树确认安装结果。实际版本号会随安装时间变化。

bash
npm install echarts
npm ls echarts

预期输出

text
<PATH>
└── echarts@<VERSION>

<PATH> 是当前项目目录,<VERSION> 是实际安装版本。若依赖树显示 empty 或命令报错,应先确认命令执行位置和包管理器锁文件是否一致。

理清实例生命周期

图表容器只有在组件挂载后才存在,因此初始化必须放在 onMounted 中。数据变化时继续复用当前实例并调用 setOption;容器尺寸变化时调用 resize;组件卸载时先停止尺寸监听,再调用 dispose 释放事件和画布资源。

Vue 组件与图表实例生命周期

重复执行 echarts.init 会创建多余实例,并可能造成事件重复、内存增长或容器占用。组件内应只保留一个实例引用,把渲染逻辑集中到单独函数中。

封装初始化、更新与销毁

下面的组件包含一组模拟趋势数据。点击按钮会追加一个数据点,监听器只调用 setOption 更新已有实例;调整容器宽度时,ResizeObserver 会触发自适应。

vue
<script setup lang="ts">
import { onBeforeUnmount, onMounted, ref, watch } from 'vue'
import * as echarts from 'echarts/core'
import { LineChart } from 'echarts/charts'
import { GridComponent, TooltipComponent } from 'echarts/components'
import { CanvasRenderer } from 'echarts/renderers'

echarts.use([LineChart, GridComponent, TooltipComponent, CanvasRenderer])

const chartRef = ref<HTMLDivElement | null>(null)
const labels = ref(['08:00', '09:00', '10:00', '11:00'])
const values = ref([120, 180, 150, 230])

let chart: ReturnType<typeof echarts.init> | null = null
let resizeObserver: ResizeObserver | null = null

function renderChart() {
  if (!chart) return

  chart.setOption({
    tooltip: { trigger: 'axis' },
    grid: { left: 44, right: 20, top: 24, bottom: 32 },
    xAxis: {
      type: 'category',
      boundaryGap: false,
      data: labels.value
    },
    yAxis: { type: 'value' },
    series: [
      {
        name: '访问量',
        type: 'line',
        smooth: true,
        data: values.value
      }
    ]
  })
}

function appendPoint() {
  const nextHour = `${8 + labels.value.length}:00`
  labels.value.push(nextHour)
  values.value.push(200)
}

watch([labels, values], renderChart, { deep: true })

onMounted(() => {
  if (!chartRef.value) return

  // 每个组件实例只初始化一次图表。
  chart = echarts.init(chartRef.value)
  resizeObserver = new ResizeObserver(() => chart?.resize())
  resizeObserver.observe(chartRef.value)
  renderChart()
})

onBeforeUnmount(() => {
  // 先停止外部监听,再释放图表内部资源。
  resizeObserver?.disconnect()
  resizeObserver = null
  chart?.dispose()
  chart = null
})
</script>

<template>
  <section class="trend-panel">
    <button type="button" @click="appendPoint">追加数据点</button>
    <div ref="chartRef" class="chart" aria-label="访问量趋势图"></div>
  </section>
</template>

<style scoped>
.trend-panel {
  width: 100%;
  padding: 16px;
  border: 1px solid #e5e7eb;
  border-radius: 12px;
  background: #fff;
}
button { margin-bottom: 12px; }
.chart { width: 100%; height: 320px; }
</style>

预期结果

text
页面显示包含 4 个时间点的平滑折线图。
点击“追加数据点”后新增一个时间点,原图表实例原地更新。
改变容器宽度时图表自动缩放;离开当前页面后实例被销毁。

处理更新边界

watch 只负责在数据改变后触发重绘,不应再次执行初始化。真实项目中可把 labels 和 values 改为组件属性,或在请求完成后一次性替换数组;高频实时数据则应限制刷新频率,避免每条消息都触发完整绘制。

图表容器必须具有明确高度,否则即使初始化成功也可能不可见。隐藏页签中的容器尺寸可能为零,页签重新显示后应补调一次 resize;服务端渲染项目还要确保初始化逻辑只在浏览器端执行。

验收图表组件

打开页面后检查图表只出现一次;连续追加数据点,确认曲线原地更新而不是叠加新画布;缩放窗口或侧边栏,确认坐标轴随容器调整;反复进入和离开路由,确认页面没有残留画布和重复事件。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入趋势图表

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

登录哪都通