ECharts-Theme-Builder 使用与安装指南

本文档旨在帮助用户详细了解并使用 ECharts-Theme-Builder 项目，该项目允许用户为 Apache ECharts 设计自定义主题。

1. 安装指南

环境准备

在开始安装前，请确保您的系统中已安装以下环境：

• Node.js
• npm (Node.js 包管理器)

安装步骤

1. 克隆项目到本地：

   git clone https://github.com/Ovilia/ECharts-Theme-Builder.git
   

2. 进入项目目录：

   cd ECharts-Theme-Builder
   

3. 安装项目依赖：

   npm install
   

4. 构建项目：

   npm run build
   

2. 项目使用说明

ECharts-Theme-Builder 提供了一个在线主题构建工具，用户可以通过该工具直观地生成主题配置文件，并在 ECharts 中使用自定义的主题样式。

使用步骤

1. 打开在线主题构建工具：ECharts-Theme-Builder
2. 根据需要调整主题样式，包括颜色、字体、轴线、刻度等。
3. 导出主题配置文件。

3. 项目API使用文档

ECharts-Theme-Builder 的 API 使用主要涉及主题的注册和使用。

主题注册

echarts.registerTheme('customed', obj);

其中，'customed' 是自定义的主题名称，obj 是从导出的 JSON 文件解析得到的对象。

主题使用

echarts.init(dom, 'customed');

其中，dom 是图表的 DOM 元素，'customed' 是注册的主题名称。

4. 项目安装方式

除了通过 npm install 的方式安装外，ECharts-Theme-Builder 还支持以下安装方式：

通过 <script> 标签引入

1. 将生成的主题文件（.js 或 .json）下载到本地。

2. 在 HTML 文件中通过 <script> 标签引入主题文件：

   <script src="path/to/theme.js"></script>
   

3. 使用 echarts.init 方法初始化图表，并指定主题名称：

   echarts.init(dom, 'customed');
   

通过本文档，用户应能够顺利安装并使用 ECharts-Theme-Builder，创建个性化的 ECharts 主题。