@echarts-component/vue

Echarts component for Vue
1,663 1
Install
npm install @echarts-component/vue
Latest Version:0.10.2
Vue:3
License:MIT
Last Updated:Nov 16, 2025
Links: GitHub  ·  npm
Maintainer: hboot

echarts-component

🧩 基于 Vue 3 的组件化 ECharts 图表框架

使用 Vue 组件的方式来配置和渲染 ECharts,让图表构建更直观、声明式、可组合。


✨ 特性

  • 🔧 所有 ECharts 配置项都是 Vue 组件
  • 🎨 多个图表类型组合支持(如 Pie、Line、Bar 混合)
  • ⚡ 响应式更新,无需手动调用 setOption
  • 💎 完整 TypeScript 类型提示
  • 💡 支持组合式 API useVueEcharts()

📦 安装

npm install @echarts-component/vue
# or
pnpm add @echarts-component/vue
# or
yarn add @echarts-component/vue

🧩 使用示例

<script setup>
import { VueEcharts, Pie, XAxis, Title } from '@echarts-component/vue'

const data = [
  { value: 40, name: 'A' },
  { value: 32, name: 'B' },
  { value: 28, name: 'C' },
]
</script>

<template>
  <VueEcharts>
    <Title text="Demo Pie Chart" left="center" />
    <XAxis :data="[1, 2, 3, 4]" />
    <Pie :data="data" :center="['50%', '50%']" />
  </VueEcharts>
</template>

🧱 支持的组件

组件名 对应配置字段 描述
<VueEcharts> 容器组件 提供 ECharts 实例并收集配置
<Pie /> series(type: pie) 饼图组件
<Line /> series(type: line) 折线图组件
<Bar /> series(type: bar) 柱状图组件
<XAxis /> xAxis X 轴配置
<YAxis /> yAxis Y 轴配置
<Title /> title 图表标题
<Grid /> grid 坐标轴网格配置
<Tooltip /> tooltip 悬浮提示
<Legend /> legend 图例组件
... ... ...

更多组件,请查看 API 文档


🧠 背后理念

该项目灵感来源于:

  • Vue 3 组合式 API 与模板语法的声明式表达
  • 将复杂 ECharts 配置模块化、组件化

目标是让每个配置项都可以通过 Vue 组件表达,使图表逻辑更清晰、可复用、响应式更自然。


🔧 开发中计划

  • 多 series 支持
    • Line 折线图
    • Bar 柱状图
    • Pie 饼图
    • more 更多图表
  • 支持 v-for 渲染多个图形
  • useVueEcharts() 组合式调用方式
  • 自动注册组件 / 按需加载
  • 主题注册 & 暗黑模式支持
  • 图表容器大小自适应

📄 License

MIT License © 2025 hboot

Related Packages

nuxt-echarts

Nuxt Module for Apache ECharts™

816,976
@autonomousminds-public/vue-better-bi

Vue 3 charting library built on ECharts with advanced formatting and theming

7,861
dr-vue-echarts

A vue-echart library

2,275 34
vue-echarts-i

在Vue使用标签声明创建eCharts图表

794

Version History

Version Released Vue License
0.10.2 ^3.5.17 MIT
0.10.1 ^3.5.17 MIT
0.9.0 ^3.5.17 MIT
0.8.0 ^3.5.17 MIT
0.7.3 ^3.5.17 MIT