当前位置：首页 > news >正文

vue3扩展echart封装为组件库-快速复用

news 2025/7/22 0:36:17

ECharts

ECharts，全称Enterprise Charts，是一款由百度团队开发并开源，后捐赠给Apache基金会的纯JavaScript图表库。它提供了直观、生动、可交互、可个性化定制的数据可视化图表，广泛应用于数据分析、商业智能、网页开发等领域。以下是关于ECharts的详细介绍：

ECharts的特点

丰富的图表类型：ECharts支持包括折线图、柱状图、散点图、饼图、盒形图、地图、热力图、雷达图、K线图等在内的多种图表类型，满足不同的数据可视化需求。
多坐标系支持：ECharts支持直角坐标系（Cartesian）、极坐标系（Polar）和地理坐标系（Geo）等多种坐标系，为图表提供了更灵活的布局和展示方式。
高度可定制：ECharts允许用户通过丰富的配置项来自定义图表的样式、颜色、交互等，实现高度个性化的数据可视化效果。
良好的兼容性：ECharts可以流畅地运行在PC和移动设备上，并兼容当前绝大部分浏览器，如IE6/7/8/9/10/11、Chrome、Firefox、Safari等。

ECharts的使用方式

引入ECharts：用户可以通过npm、CDN或GitHub等方式引入ECharts。
准备一个DOM容器：在HTML中定义一个具有宽高的<div>容器，用于承载图表。
初始化ECharts实例：使用echarts.init(dom)方法初始化一个ECharts实例，其中dom是前面准备的DOM容器的引用。
配置图表选项：通过编写一个包含图表配置项的对象（通常称为option），来指定图表的类型、数据、样式等。
设置图表选项：使用ECharts实例的setOption(option)方法，将配置好的option应用到图表上，实现图表的渲染。

ECharts的示例

以下是一个简单的ECharts柱状图示例：

<!DOCTYPE html>  
<html>  
<head>  <meta charset="utf-8">  <title>ECharts 示例</title>  <!-- 引入 ECharts -->  <script src="https://cdn.jsdelivr.net/npm/echarts/dist/echarts.min.js"></script>  
</head>  
<body>  <!-- 准备一个具备大小（宽高）的Dom -->  <div id="main" style="width: 600px;height:400px;"></div>  <script type="text/javascript">  // 基于准备好的dom，初始化echarts实例  var myChart = echarts.init(document.getElementById('main'));  // 指定图表的配置项和数据  var option = {  title: {  text: 'ECharts 示例'  },  tooltip: {},  legend: {  data:['销量']  },  xAxis: {  data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]  },  yAxis: {},  series: [{  name: '销量',  type: 'bar',  data: [5, 20, 36, 10, 10, 20]  }]  };  // 使用刚指定的配置项和数据显示图表。  myChart.setOption(option);  </script>  
</body>  
</html>

vue3扩展echart封装为组件库

在Vue 3中扩展ECharts并将其封装为可复用的组件库：

封装ECharts组件

首先，你需要创建一个ECharts组件，该组件接受必要的props（如选项、宽度、高度等。

<template><div ref="chartRef" :style="{ width, height }"></div>
</template><script setup name="chart">
import { onMounted, ref } from 'vue';
import * as echarts from 'echarts';import { useResizeObserver, useVModel } from '@vueuse/core';const props = defineProps({modelValue: {type: Object,default: {},},height: {type: String,default: '100%',},width: {type: String,default: '100%',},
});const emit = defineEmits(['update:modelValue']);
const data = useVModel(props, 'modelValue', emit);
const chartRef = ref();
let chart = ref();const initChart = () => {if (chartRef.value) {chart = echarts.init(chartRef.value);chart.setOption(data.value);}
};// 定义一个函数来处理尺寸变化
const handleResize = () => {if (chart) {setTimeout(() => {chart.resize();}, 100);}
};const setOption = (option) => {if (chartRef.value) {chart = echarts.init(chartRef.value);chart.setOption(option);}
};onMounted(() => {initChart();// 监听窗口大小变化if (chartRef.value) {useResizeObserver(chartRef.value.parentNode, handleResize);}
});
const getChart = () => {return chart;
};
defineExpose({getChart,setOption,
});
</script>

组件调用

<template><div class="container"><div style="height: 214px" class="flex diygw-col-12"><diy-echart ref="echartRef" v-model="echartOpts" /></div><div style="height: 214px" class="flex diygw-col-12"><diy-echart ref="echart1Ref" v-model="echart1Opts" /></div><div class="clearfix"></div></div>
</template><script setup name="index">import { ElMessageBox, ElMessage } from 'element-plus';import { ref, toRefs, reactive, onMounted, getCurrentInstance, onUnmounted } from 'vue';import { useRouter, useRoute } from 'vue-router';import { storeToRefs } from 'pinia';import { useUserInfo } from '@/stores/userInfo';import DiyEchart from '@/components/echart/index.vue';const stores = useUserInfo();const { userInfos } = storeToRefs(stores);const { proxy } = getCurrentInstance();const router = useRouter();const route = useRoute();const globalOption = ref(route.query);const getParamData = (e, row) => {row = row || {};let dataset = e.currentTarget ? e.currentTarget.dataset : e;if (row) {dataset = Object.assign(dataset, row);}return dataset;};const navigateTo = (e, row) => {let dataset = getParamData(e, row);let { type } = dataset;if ((type == 'page' || type == 'inner' || type == 'href') && dataset.url) {router.push({path: (dataset.url.startsWith('/') ? '' : '/') + dataset.url,query: dataset});} else {ElMessage.error('待实现点击事件');}};const state = reactive({userInfo: userInfos.value,echartOpts: { xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] }, yAxis: { type: 'value' }, series: [{ data: [150, 230, 224, 218, 135, 147, 260], type: 'line' }] },echart1Opts: { xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] }, yAxis: { type: 'value' }, series: [{ data: [120, 200, 150, 80, 70, 110, 130], type: 'bar' }] }});const { userInfo, echart1Opts, echartOpts } = toRefs(state);const init = async () => {};// 页面加载时onMounted(async () => {await init();});// 页面卸载时onUnmounted(() => {});
</script><style lang="scss" scoped>.container {font-size: 12px;}
</style>

查看全文

http://www.lryc.cn/news/444352.html