图表类组件
图表类组件
基于 ECharts 的可视化图表,共 18 种。它们共享一套设计:
- 通用参数:
title/title-show/title-color(标题)、show-legend(图例)、show-label(数值标签),以及各自的坐标轴 / 颜色项。 - 通用触发器:
itemClicked(点击某项,payload = 该项的类目维度,如{城市:"北京"})。 - 数据绑定:在属性面板「数据」页签点选字段即可(自动生成三元组)。多数直角坐标系图表是「类目字段(1)+ 数值字段(≥1,每个字段一条系列)」,饼 / 水球 / 仪表盘等是「类目 + 数值」或「单数值」。
各图表的完整样式项以属性面板为准,全量参数字典由源码自动导出。
柱状图 chart-bar
最常用的对比类图表。默认尺寸 [420, 300]。
参数:
| option | 默认 | 说明 |
|---|---|---|
direction | vertical | 方向:vertical / horizontal(横向条形) |
bar-color | #3aa1ff | 柱颜色 |
bar-width | 45 | 柱宽(10~100%) |
bar-radius | 4 | 圆角 |
show-label / show-legend | false | 数值标签 / 图例 |
| 坐标轴 | — | chart-axis-color、chart-axis-label-color、split-line |
数据绑定:category-field(string, 恰 1)+ metric-fields(number, ≥1,每字段一条系列)。
{ "type": "chart-bar", "uid": "w_bar", "options": {
"category-field": [["conn","tbl","月份"]],
"metric-fields": [["conn","tbl","销售额"],["conn","tbl","利润"]] } }折线图 chart-line / 面积图 chart-area
与柱状图同构(同样的类目 + 数值绑定与坐标轴),区别在渲染为折线 / 填充面积。适合趋势展示。
参数:line-color / line-width、smooth(平滑曲线)、show-symbol + symbol-size(数据点)、show-area + area-opacity(面积填充;chart-area 默认开)、flow-light(流光动画)、show-label / show-legend、坐标轴 chart-axis-color / chart-axis-label-color / split-line。
数据绑定:category-field(1)+ metric-fields(≥1,每字段一条系列)。
双轴图 chart-biaxial / 双轴堆叠 chart-biaxial-stack
一个类目轴 + 左右两个数值轴,用于「量 + 率」同图(如销售额柱 + 增长率线):柱走左轴、折线走右轴。堆叠版把同侧多柱堆叠。默认尺寸 [460, 320]。
参数:bar-color / bar-width / bar-radius / bar-stack(柱)、line-color / line-width / smooth / show-symbol(折线)、left-axis-name / right-axis-name(左右轴名)、show-legend / show-label、坐标轴样式。
数据绑定:category-field(1)+ metric-fields(柱,左轴,≥0)+ line-metric-fields(折线,右轴,≥0)。
饼图 chart-pie
占比类图表。默认尺寸 [420, 320]。
参数:radius(半径 10~90%)、rose(南丁格尔玫瑰)、show-legend(默认 true)、show-label、label-color。
数据绑定:category(string, 1)+ value(number, 1)。
仪表盘 chart-gauge
单指标进度 / 占比表盘。默认尺寸 [320, 280]。
参数:static-value / min-value / max-value(值与量程)、split-number(刻度段数)、pointer-color / arc-color / ring-color / tick-color(指针 / 弧面 / 外圈 / 刻度色)、show-detail + detail-color / unit(数值显示)。
数据绑定:value-field(number, 0~1)。
水球图 chart-liquid
单百分比水位球。默认尺寸 [280, 280]。
参数:static-value / max-value、liquid-shape(circle / rect / roundRect / triangle / diamond / pin / arrow)、wave-color-from / wave-color-to(波浪渐变)、bg-color、show-outline、label-size / label-color。
数据绑定:value-field(number, 0~1)。
散点图 chart-scatter
相关性 / 分布,可开气泡模式(第三维度控制点大小)。默认尺寸 [420, 320]。
参数:point-color / point-size、bubble-mode(气泡模式)、split-line(网格线)、chart-axis-color / chart-axis-label-color。
数据绑定:x-field(number, 1)+ y-field(number, 1)+ size-field(number, 0~1,气泡大小)。
雷达图 chart-radar
多维对比。默认尺寸 [420, 340]。
参数:radar-shape(polygon / circle)、radar-radius(半径 %)、area-opacity(面积透明度)、show-legend、axis-name-color(指标名颜色)。
数据绑定:indicator-field(string, 1,指标名)+ metric-fields(number, 1~6,每字段一条系列)。
区域地图 chart-map
行政区 choropleth(按值填色)。默认尺寸 [520, 420]。
参数:map-region(china 或省级行政区码)、area-color / area-border-color / hover-color、low-color / high-color(值域两端色)、show-label / label-color、show-visualmap(色条)、enable-roam(缩放拖拽)。
数据绑定:region-field(string, 1,区域名,需与地图区域名匹配)+ value-field(number, 1)。
需要在地图上叠加标绘 / 特效 / 轨迹,请用功能更完整的 2D 地图子系统(
chart-map仅是 ECharts 区域填色图)。
漏斗图 chart-funnel
转化 / 层级递减。默认尺寸 [420, 320]。
参数:funnel-sort(descending / ascending)、label-position、gap(层间距)、show-legend、label-color。
数据绑定:category(string, 1)+ value(number, 1)。
矩形树图 chart-treemap
层级占比。默认尺寸 [460, 340]。
参数:show-label / label-color、gap-width(块间距)、show-breadcrumb(面包屑导航)。
数据绑定:name-field(string, 1)+ value-field(number, 1)+ group-field(string, 0~1,父级分组做层级)。
热力图 chart-heatmap
二维密度矩阵。默认尺寸 [460, 340]。
参数:low-color / high-color(值域两端色)、show-label、show-visualmap(色条)、chart-axis-label-color。
数据绑定:x-field(string, 1)+ y-field(string, 1)+ value-field(number, 1)。
桑基图 chart-sankey
流向 / 分配。默认尺寸 [480, 360]。
参数:node-width / node-gap(节点宽度 / 间隙)、link-curveness(链路弧度)、label-color。
数据绑定:source-field(string, 1,来源)+ target-field(string, 1,去向)+ value-field(number, 1,流量)。
关系图 chart-graph
网络 / 拓扑(力导向)。默认尺寸 [480, 360]。
参数:node-color / node-size、link-color、show-label / label-color、repulsion(斥力,越大节点越散)。
数据绑定:source-field(string, 1)+ target-field(string, 1)+ value-field(number, 0~1,边权 / 节点值)。
词云 chart-wordcloud
词频。默认尺寸 [420, 300]。
参数:cloud-shape(circle / cardioid / diamond / triangle / pentagon / star)、font-min / font-max(字号区间)、allow-rotate(允许旋转)。
数据绑定:word-field(string, 1,词条)+ weight-field(number, 1,权重)。
胶囊柱图 chart-capsule
排名条。默认尺寸 [360, 280]。
参数:item-height(胶囊高度)、show-value + unit、text-color / font-size、capsule-colors(配色,逗号分隔)。
数据绑定:category(string, 1)+ value(number, 1)。