@macroui/echarts

@macroui/echarts 是基于 Apache ECharts 构建的可视化组件库，由 macroui 团队维护与发行，提供开箱即用、响应 macroui 设计体系的图表能力。它沿用 ECharts 强大的交互式图表与数据可视化能力，并基于 zrender 轻量级 canvas 库渲染。

@macroui/echarts is a charting and data-visualization library published by the macroui team, built on top of Apache ECharts. It provides the same powerful, interactive and highly customizable charting experience, rendered through the lightweight zrender canvas library, while integrating seamlessly with the macroui design system.

中文官网: https://echarts.macroui.com · English: https://echarts.macroui.com/en

安装 / Install

# npm
npm install @macroui/echarts --save

# yarn
yarn add @macroui/echarts

# pnpm
pnpm add @macroui/echarts

快速开始 / Quick Start

import * as echarts from '@macroui/echarts';

// 初始化图表
const chart = echarts.init(document.getElementById('main'));

chart.setOption({
  title: { text: 'Hello macroui/echarts' },
  tooltip: {},
  xAxis: { data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] },
  yAxis: {},
  series: [{ type: 'bar', data: [120, 200, 150, 80, 70, 110, 130] }]
});

提示：在 Vue / React 项目中推荐搭配 @macroui/echarts-vue 使用，可直接以组件方式接入。

文档 / Documentation

• 快速上手：https://echarts.macroui.com/handbook
• API 参考：https://echarts.macroui.com/api
• 配置项手册：https://echarts.macroui.com/option
• 示例：https://echarts.macroui.com/examples

获取帮助 / Get Help

• Gitee Issues 用于 bug 反馈与功能请求
• 邮箱 [email protected] 用于一般问题咨询

源码构建 / Build

构建 @macroui/echarts 源码（需要 Node.js）：

# 安装依赖
npm install

# 监听源码变化并实时构建
npm run dev

# 类型检查
npm run checktype

# 生产构建（生成 dist 目录下的产物）
npm run release

参与贡献 / Contributing

欢迎通过 Pull Request 与 Issue 参与贡献，提交前请阅读仓库中的 CONTRIBUTING.md。

相关生态 / Related Projects

• @macroui/echarts-vue macroui 官方 Vue 组件封装
• @macroui/ui macroui 设计体系组件库
• Apache ECharts 上游原仓库
• zrender 底层图形渲染库

仓库 / Repository

• 源码仓库：https://gitee.com/macroui/echarts
• NPM 包：@macroui/echarts

许可协议 / License

@macroui/echarts 基于 Apache License 2.0 开源。