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,不会保留无效图表实例
按自己的节奏,确认真正理解。