Vue 引入 ECharts

在 Vue3 中使用 ECharts 可以通过以下步骤实现，这里为你提供一个完整的集成指南：

---

1. 安装 ECharts

npm install echarts --save
  # 或
yarn add echarts

---

2. 基础使用（直接在组件中）

<template>
  <div ref="chartDom" style="width: 600px; height: 400px"></div>
</template>
<script setup>
import { ref, onMounted, onUnmounted } from 'vue'
import * as echarts from 'echarts'

const chartDom = ref(null)
let myChart = null

// 初始化图表
const initChart = () => {
  myChart = echarts.init(chartDom.value)
  // 配置项对象
  const option = {
    title: { text: '示例图表' },
    tooltip: {},
    xAxis: { data: ['衬衫', '羊毛衫', '雪纺衫', '裤子', '高跟鞋', '袜子'] },
    yAxis: {},
    series: [{
      name: '销量',
      type: 'bar',
      data: [5, 20, 36, 10, 10, 20]
    }]
  }
  //使用配置
  myChart.setOption(option)
}

// 生命周期钩子
onMounted(() => {
  //挂载后才能操作DOM
  initChart()
})

onUnmounted(() => {
  if (myChart) {
    myChart.dispose() // 销毁实例
  }
})
</script>

---

3. 创建可复用图表组件（推荐）

<!-- components/EChartsWrapper.vue -->
<template>
  <div ref="chartContainer" :style="{ width, height }"></div>
</template>
<script setup>
import { ref, watch, onBeforeUnmount } from 'vue'
import * as echarts from 'echarts'

const props = defineProps({
  option: {
    type: Object,
    required: true
  },
  width: {
    type: String,
    default: '100%'
  },
  height: {
    type: String,
    default: '400px'
  }
})

const chartContainer = ref(null)
let chartInstance = null

// 初始化图表
const initChart = () => {
  chartInstance = echarts.init(chartContainer.value)
  chartInstance.setOption(props.option)
}

// 监听配置变化
watch(
  () => props.option,
  (newVal) => {
    chartInstance?.setOption(newVal)
  },
  { deep: true }
)

// 生命周期
onBeforeUnmount(() => {
  chartInstance?.dispose()
})

// 初始化
initChart()
</script>

---

4. 在父组件中使用

<template>
  <EChartsWrapper :option="chartOption" />
</template>
<script setup>
import EChartsWrapper from './components/EChartsWrapper.vue'

const chartOption = {
  title: { text: '动态更新示例' },
  tooltip: { trigger: 'axis' },
  xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] },
  yAxis: { type: 'value' },
  series: [{
    data: [120, 200, 150, 80, 70, 110, 130],
    type: 'line',
    smooth: true
  }]
}
</script>

---

5. 高级用法技巧

动态更新数据

// 在组件中
    const updateData = () => {
    const newData = [Math.random() * 100, ...chartOption.series[0].data.slice(0,6)]
    chartOption.series[0].data = newData
    }

按需引入减小体积

// 只引入需要的模块
    import { use } from 'echarts/core'
    import { CanvasRenderer } from 'echarts/renderers'
    import { BarChart } from 'echarts/charts'
    import {
    TitleComponent,
    TooltipComponent,
    GridComponent
    } from 'echarts/components'

    use([
    CanvasRenderer,
    BarChart,
    TitleComponent,
    TooltipComponent,
    GridComponent
    ])

响应式容器

<template>
  <div class="chart-container">
    <EChartsWrapper :option="chartOption" />
  </div>
</template>
<style>
.chart-container {
  width: 100%;
  height: 50vh;
  padding: 20px;
  box-sizing: border-box;
}
</style>

---

核心配置项分类

1. 标题 (title)

title: {
  text: '主标题',          // 主标题文本
    subtext: '副标题',      // 副标题文本
    left: 'center',         // 标题位置（left/center/right）
    textStyle: {            // 文本样式
    color: '#333',
      fontSize: 18
  }
}

2. 图例 (legend)

legend: {
  data: ['销量', '库存'], // 图例项名称数组
    top: 'bottom',          // 位置（top/bottom/left/right）
    orient: 'horizontal'    // 布局方向（horizontal/vertical）
}

3. 坐标轴 (xAxis/yAxis)

xAxis: {
  type: 'category',       // 坐标轴类型（category/value/time等）
    data: ['衬衫', '羊毛衫'], // 类别数据（仅 category 类型需要）
    name: '产品',            // 坐标轴名称
    axisLabel: {            // 坐标轴标签配置
    rotate: 45            // 标签旋转角度
  }
}

4. 系列 (series)

series: [{
  name: '销量',            // 系列名称（对应图例）
  type: 'bar',            // 图表类型（bar/line/pie等）
  data: [5, 20, 36],      // 数据数组
  smooth: true,           // 是否平滑曲线（仅 line 有效）
  itemStyle: {            // 图形样式
    color: '#5470c6'
  },
  label: {                // 数据标签配置
    show: true,
    position: 'top'
  }
}]

5. 提示框 (tooltip)

tooltip: {
  trigger: 'axis',        // 触发类型（axis/item）
    formatter: '{b}: {c}'   // 格式化函数（{a}系列名, {b}数据名, {c}数值）
}

6. 工具箱 (toolbox)

toolbox: {
  feature: {
    saveAsImage: {},      // 保存图片
    dataView: {},         // 数据视图
    restore: {}           // 重置配置
  }
}

---

其他重要配置

• 颜色调色板 ：通过 color 数组定义全局颜色序列

color: ['#5470c6', '#91cc75', '#fac858']

• 响应式设计 ：使用 grid 控制图表区域大小

grid: {
  left: '10%',
    right: '10%',
    containLabel: true // 防止标签溢出
}

• 动画配置：

animation: true,          // 是否开启动画
  animationDuration: 1000   // 动画时长（ms）

---

动态更新

通过 setOption 更新配置时，可指定 notMerge: true 完全替换原有配置，或 lazyUpdate: true 延迟渲染。

---

完整示例

option = {
  title: { text: '销售数据' },
  tooltip: { trigger: 'axis' },
  legend: { data: ['销量', '库存'] },
  xAxis: {
    type: 'category',
      data: ['衬衫', '羊毛衫', '雪纺衫']
  },
  yAxis: { type: 'value' },
  series: [
    { name: '销量', type: 'bar', data: [5, 20, 36] },
    { name: '库存', type: 'line', data: [10, 25, 30] }
  ]
}

---

最佳实践

1. 按需引入 ：通过 echarts/core + 按需加载模块减小体积
2. 类型验证 ：使用 TypeScript 时配合 @types/echarts 获得类型提示
3. 官方文档 ：遇到具体配置项时，建议直接查阅 ECharts 官方配置手册

如果需要实现特定效果（如 3D 图表、地图可视化等），可进一步研究 echarts-gl 扩展和地图注册方法。