图表总览与快速上手
EvChart 是 evoke-business-ui 内置的 Canvas 自绘图表引擎:零图表库依赖,ECharts 风格的 options 配置式声明,内置图例点选、tooltip、dataZoom 缩放、框选、联动与暗色模式;高清屏自动按 devicePixelRatio 渲染,数据变化时自动做数值补间动画,空数据、加载中与渲染错误均有内置占位。
心智模型
一张图 = 选类型 → 给数据 → 调配置 三步,全部收敛在一个 options 对象里:
vue
<ev-chart
:options="{
type: 'bar', // 1. 选类型
title: '季度营收',
labels: ['Q1', 'Q2', 'Q3', 'Q4'], // 2. 给数据(按类型选字段)
series: [{ name: '营收(万)', data: [320, 402, 361, 490] }],
legend: { show: true }, // 3. 调配置(图例 / tooltip / 轴 / 缩放…)
}"
:height="260"
/>- 直角坐标系家族(line / bar / area / stacked-bar / horizontal-bar / waterfall / mixed 等)共用
labels+series数据模型; - 饼系、雷达、仪表盘、散点、热力等各有专属数据字段(
pieData、radarSeries、gauge…),见选型指南; - 所有类型共享图例、tooltip、动画、值格式化、主题等顶层配置。
选型指南
按"想回答什么问题"选图:
| 想回答的问题 | 推荐类型 |
|---|---|
| 趋势怎么走?多组趋势对比? | 折线图 / 面积图 / 迷你趋势图 |
| 分类之间比大小?构成怎么堆叠? | 柱状图 / 堆叠柱状图 / 条形图 |
| 增减瀑布 / 多指标混合坐标? | 瀑布图 / 混合图 |
| 占比构成?部分与整体? | 饼图 / 环形图 / 玫瑰图 / 漏斗图 |
| 单指标完成得怎么样? | 仪表盘 / 子弹图 |
| 两/三个变量有没有关系?密度在哪? | 散点图 / 热力图 |
| 数据分布、离群值?金融波动? | 直方图 / 箱线图 / K 线图 |
| 层级构成怎么拆?多维能力对比? | 矩形树图 / 旭日图 / 雷达图 |
每个类型都有独立的说明页(何时使用、示例、配置要点),从左侧导航或上表直达。
快速上手
一个最简单的折线图,labels 是 x 轴类目,series 每项是一条线:
多系列自动出现图例,点击图例可显隐对应系列;悬浮出现 tooltip。
运行时更新
options 响应式变化后图表自动增量合并重绘:同结构数据走数值补间动画,而不是闪屏重绘;改 type 只需换一个字段,labels + series 数据模型完全复用——这是直角坐标系家族的通用红利。容器尺寸变化默认自动重绘(responsive,默认开启)。