Vue / 系统课时

实现分类统计图

实现分类统计图

分类统计图的难点不在画出扇区,而在于把接口字段稳定转换为图表数据,并在刷新、空数据和组件卸载时保持状态正确。本课将完成一个可复用的 Vue 3 + ECharts 分类统计组件。

学习目标

  • 将接口统计结果转换为 ECharts 饼图所需的数据结构
  • 配置图例、提示框和空数据展示
  • 正确处理数据更新与图表实例销毁

明确接口到图表的数据契约

后端常返回分类名称与数量,例如 categoryName 和 count;ECharts 饼图需要 { name, value }。转换层应同时完成去空名称、数值归一化和无效数据过滤,避免把接口格式直接散落到图表配置中。

组件对外只接收分类统计数组。接口返回后,页面把响应数据赋给组件的 data 属性;组件内部再统一转换。这样即使后端字段或图表库变化,也只需修改一个适配位置。

编写可复用图表组件

下面是片段示例,依赖 Vue 3 与已安装的 echarts。图表容器始终保留,空数据时只显示覆盖提示,因此后续拿到数据后不需要重新创建 DOM。

vue
<script setup lang='ts'>
import { computed, onBeforeUnmount, onMounted, ref, watch } from 'vue'
import * as echarts from 'echarts'

type CategoryStat = {
  categoryName: string
  count: number | string
}

const props = withDefaults(defineProps<{ data?: CategoryStat[] }>(), {
  data: () => []
})

const chartRef = ref<HTMLDivElement | null>(null)
let chart: echarts.ECharts | null = null

// 统一把接口字段转换为图表契约,并过滤异常统计值
const seriesData = computed(() =>
  props.data
    .map(item => ({
      name: item.categoryName.trim() || '未分类',
      value: Number(item.count)
    }))
    .filter(item => Number.isFinite(item.value) && item.value > 0)
)

function renderChart() {
  if (!chart) return

  // 空数组时清理旧扇区,避免继续展示上一次结果
  if (seriesData.value.length === 0) {
    chart.clear()
    return
  }

  // 使用替换模式更新,分类减少时不会残留旧系列
  chart.setOption(
    {
      tooltip: {
        trigger: 'item',
        formatter: '{b}<br/>{c} 项({d}%)'
      },
      legend: {
        bottom: 0,
        type: 'scroll'
      },
      series: [
        {
          name: '分类统计',
          type: 'pie',
          radius: ['55%', '72%'],
          center: ['50%', '44%'],
          avoidLabelOverlap: true,
          data: seriesData.value
        }
      ]
    },
    true
  )
}

onMounted(() => {
  if (!chartRef.value) return
  chart = echarts.init(chartRef.value)
  renderChart()
})

watch(seriesData, renderChart, { deep: true })

onBeforeUnmount(() => {
  // 页面离开后释放 Canvas、事件和内部缓存
  chart?.dispose()
  chart = null
})
</script>

<template>
  <!-- 图表容器始终存在,空状态覆盖在其上方 -->
  <div class='category-chart'>
    <div ref='chartRef' class='chart-canvas'></div>
    <p v-if='seriesData.length === 0' class='empty-state'>暂无分类数据</p>
  </div>
</template>

<style scoped>
.category-chart {
  /* 保留确定高度,避免 ECharts 在零高度容器中初始化 */
  position: relative;
  min-height: 320px;
}

.chart-canvas {
  width: 100%;
  height: 320px;
}

.empty-state {
  position: absolute;
  inset: 0;
  display: grid;
  place-items: center;
  margin: 0;
  color: #909399;
}
</style>

预期结果

text
传入“待处理 12、处理中 8、已完成 20”后,页面显示三段环形分类图。
图例位于底部;悬停扇区时显示分类名、数量和占比。
传入空数组或全部为 0 的数据时,图表清空并显示“暂无分类数据”。

处理刷新与异常数据

setOption 的第二个参数设为 true,表示用新配置替换旧配置,避免分类减少后仍残留旧扇区。数量先经 Number 转换,再过滤非有限值和非正数,可处理接口偶尔返回数字字符串的情况。

加载状态应由父页面单独控制,不要把“请求中”和“无数据”混为一谈。请求完成且数组为空时才显示空状态;请求失败则展示错误提示或重试入口,而不是继续保留上一次成功数据。

验证关键边界

  • 分类名称为空时显示“未分类”,不会产生空图例
  • 分类数量为字符串时能正确转换,非法值不会进入图表
  • 数据从多项变为少项时,旧扇区会被移除
  • 组件离开页面后调用 dispose,不会保留无效图表实例
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现分类统计图

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

登录哪都通