图表总览与快速上手

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 数据模型;
  • 饼系、雷达、仪表盘、散点、热力等各有专属数据字段(pieDataradarSeriesgauge…),见选型指南
  • 所有类型共享图例、tooltip、动画、值格式化、主题等顶层配置。

选型指南

按"想回答什么问题"选图:

想回答的问题推荐类型
趋势怎么走?多组趋势对比?折线图 / 面积图 / 迷你趋势图
分类之间比大小?构成怎么堆叠?柱状图 / 堆叠柱状图 / 条形图
增减瀑布 / 多指标混合坐标?瀑布图 / 混合图
占比构成?部分与整体?饼图 / 环形图 / 玫瑰图 / 漏斗图
单指标完成得怎么样?仪表盘 / 子弹图
两/三个变量有没有关系?密度在哪?散点图 / 热力图
数据分布、离群值?金融波动?直方图 / 箱线图 / K 线图
层级构成怎么拆?多维能力对比?矩形树图 / 旭日图 / 雷达图

每个类型都有独立的说明页(何时使用、示例、配置要点),从左侧导航或上表直达。

快速上手

一个最简单的折线图,labels 是 x 轴类目,series 每项是一条线:

多系列自动出现图例,点击图例可显隐对应系列;悬浮出现 tooltip。

运行时更新

options 响应式变化后图表自动增量合并重绘:同结构数据走数值补间动画,而不是闪屏重绘;改 type 只需换一个字段,labels + series 数据模型完全复用——这是直角坐标系家族的通用红利。容器尺寸变化默认自动重绘(responsive,默认开启)。

下一步

  • 按数据形态挑图:左侧「图表类型」四个章节
  • 图例、tooltip、缩放、联动、导出:交互与联动
  • 完整字段与实例方法:API 参考