vue-echarts-linkage
v1.4.3
Published
## 1. 介绍
Downloads
1,317
Readme
vue-echarts-linkage
1. 介绍
vue-echarts-linkage 是基于 Vue3 + TypeScript + Element Plus 实现的联动组件,可以实现多个图表之间的联动。
2. demo演示
2.1 基础联动
多图表联动放缩,Y轴同步对齐
2.2 图例联动
图例显示隐藏同步,重置图例位置显示,移除图例等
2.3 开关量显示
2.4 图形定位
2.5 主题背景自定义
背景色自定义,白天黑夜切换
2.6 容器尺寸实时自适应
容器尺寸实时自适应,图表内容字体和位置自适应容器大小
2.7 联动模式切换
非联动模式,开关量显示,图形定位,主题背景自定义,容器尺寸实时自适应
3. 安装及使用组件
3.1 安装组件
# 安装依赖
npm install vue-echarts-linkage
or
pnpm install vue-echarts-linkage
# 全局安装组件
import VueEchartsLinkage from "vue-echarts-linkage";
import "vue-echarts-linkage/dist/style.css";
...
const app = createApp(App);
app.use(VueEchartsLinkage);
# 按需引入组件
import { VueEchartsLinkage } from "vue-echarts-linkage";
import "vue-echarts-linkage/dist/style.css";
3.2 使用组件
<template>
...
<VueEchartsLinkage
ref="echartsLinkageRef"
:cols="1"
:echarts-max-count="10"
:echarts-colors="['red', 'blue', 'green', 'yellow', 'goldenrod', 'skyblue']"
language="zh-cn"
grid-align
...
@drop-echart="dropEchart" />
</template>
import { VueEchartsLinkage, type OneDataType, type SeriesTagType, type DropEchartType } from 'vue-echarts-linkage';
import "vue-echarts-linkage/dist/style.css";
...
const echartsLinkageRef = ref<InstanceType<typeof VueEchartsLinkage>>();
...
// 拖拽回调事件
const dropEchart = (data: dropEchartType) => {
// 处理拖拽回调后逻辑
...
}
4. 组件属性
| 属性名 | 类型 | 说明 | 默认值 |
| --- | --- | --- | --- |
| cols | number
| 自定义配置的显示列数 | 1,即单列 |
| echarts-max-count | number
| 允许的最大图表数 | 7 |
| empty-echart-count | number
| 初始化生成的空白图表数 | — |
| echarts-colors | string[]
| legend、series和对应Y轴颜色数组 | ['#0078FF', '#FFAA2E', '#00FF00', '#9D2EFF', '#DA1D80', '#DA4127'] |
| segment | number / { mode: 'interval' | 'percent', value: number }
| 标线分段数, number表示分段数,object表示分段配置;当mode为'interval'时,value表示分段数,当mode为'percent'时,表示显示能被value整除的数值 | - |
| language | zh-cn / en-us
| 语言设置,目前只支持中文(zh-cn)和英文(en-us) | zh-cn,即中文 |
| grid-align | boolean
| 多echarts图表是否对齐 | false |
| theme | light / dark
| 主题,light为浅色,dark为深色 | light |
| background | string
| 背景色,一般配合主题使用 | — |
| is-linkage | boolean
| 是否联动 | true,即联动 |
| use-merged-legend | boolean
| 是否使用合并图例 | true,即使用合并图例 |
| use-graphic-location | boolean
| 是否使用图形定位 | true,即使用图形定位 |
5. 组件事件
| 事件名 | 说明 | 参数 |
| --- | --- | --- |
| drop-echart | 拖拽图表回调事件,返回当前拖拽的图表id(data.id) | (data: DropEchartType)
|
| delete-echart | 删除图表回调事件,返回当前删除的图表id(data.id) | (data: DeleteEchartType)
|
| listener-graphic-location | 监听图形定位事件,返回所有图形定位信息 | (data: ListenerGrapicLocationType)
|
6. 组件方法
| 方法名 | 说明 | 参数 |
| --- | --- | --- |
| addEchart | 添加一个echarts图表 | (data?: OneDataType / OneDataType[]) => void
|
| addEchartSeries | 新增echarts系列,一般配置拖拽回调事件(@drop-echart)使用 | (id: string, data: OneDataType) => void
|
| deleteEchart | 根据echarts的id删除echarts | (id: string) => Promise<void>
|
| getDataLength | 获取数据总数 | () => number
|
| getMaxEchartsIdSeq | 获取最大的id序号 | () => number
|
| getAllDistinctSeriesTagInfo | 获取所有不重复系列的标签信息 | () => Array<SeriesTagType>
|
| getAllSeriesTagInfo, | 获取所有系列的标签信息 | (echartsId?: string) => Array<{ id: string; series: Array<SeriesTagType>; }>
|
| updateAllEcharts | 传入所有显示子项数据,更新所有echarts,一般配置 getAllDistinctSeriesTagInfo()
使用 | (newAllSeriesdata: Array<SeriesTagType>) => Promise<void>
|
| clearAllEchartsData | 清空所有echarts数据:当mode为'clear'时,清除数据保留当前空白echarts实例,当mode为'delete'时,删除当前实例 | (mode?: "clear" / "delete") => Promise<void>
|
| replaceAllEchartsData | 替换所有echarts,内部为先清除再添加,保证新旧echarts图表数量和数据不存在关联性 | (newDataArray: Array<OneDataType[]>) => Promise<void>
|
| downloadAllEchartsImg | 下载包含所有echarts实例的图片 | () => void
|
| realTimeUpdate | 新增实时数据更新 | (allRealTimeData: Array<SeriesTagType>, limitCount?: number) => void
|
| updateOneEchartsVisualMapSeries | 更新单个echarts的visualMap数据,自定义每个series中不同报警区间,默认报警色为红色 | (id: string, data: VisualMapSeriesType[] / VisualMapSeriesType) => void
|
| handleMultipleLinkData | 处理前后关联数据,多条关联数据进行首尾相连操作 | (primaryData: OneDataType) => OneDataType
|