查看“ECharts”的源代码

Echarts，是一个免费开源的可视化图表库。它是用 [[JavaScript]]（TypeScript）编写的，底层基于矢量图形库ZRender。

==简介==
===时间轴===
* 2013年6月3日，发布Echarts 1.0.0。
* 2018年1月16日，ECharts进入Apache Incubator进行孵化。
* 2020年12月16日，ECharts在孵化器毕业，成为Apache软件基金会的顶级项目。

{{了解更多
|[https://github.com/apache/echarts/releases GitHub：Echarts 发布]
}}
===安装===
1.下载引入。从 https://github.com/apache/echarts/releases 上下载echarts.js，一般放入js目录中，在HTML页面引入即可：
<syntaxhighlight lang="HTML">
<script src="echarts.js"></script>
</syntaxhighlight>

2.使用CDN。 如从 jsDelivr 引用 echarts。
<syntaxhighlight lang="HTML">
<script src="https://cdn.jsdelivr.net/npm/echarts@5.2.0/dist/echarts.min.js"></script>
</syntaxhighlight>


3.从 npm 获取。
 npm install echarts --save

{{了解更多
|[https://echarts.apache.org/handbook/zh/basics/download Echarts 文档：获取Echarts ]
|[https://echarts.apache.org/zh/download.html Echarts 下载]
}}

==基础知识==
===快速上手===
使用ECharts基本上为5步：
* 引入echarts.js文件。
* 准备一个定义了宽高的DOM容器。
* 初始化echarts实例。通过调用init()函数。
* 准备图表配置项。为[[JSON]]格式，声明了图表类型、样式、数据和交互。
* 将配置项设置给echarts实例。通过实例调用setOption()函数。

<syntaxhighlight lang="html">
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <title>ECharts</title>
    <!-- 1. 引入 ECharts 文件 -->
    <script src="js/echarts.min.js"></script>
  </head>
  <body>

    <!-- 2. 为 ECharts 准备一个定义了宽高的 DOM -->
    <div id="main" style="width: 600px;height:400px;"></div>

    <script type="text/javascript">
      // 3. 基于准备好的dom，初始化echarts实例
      var myChart = echarts.init(document.getElementById('main'));

      // 4. 指定图表的配置项和数据
      var option = {
        title: {
          text: 'ECharts 入门示例'
        },
        tooltip: {},
        legend: {
          data: ['销量']
        },
        xAxis: {
          data: ['衬衫', '羊毛衫', '雪纺衫', '裤子', '高跟鞋', '袜子']
        },
        yAxis: {},
        series: [
          {
            name: '销量',
            type: 'bar',
            data: [5, 20, 36, 10, 10, 20]
          }
        ]
      };

      // 5. 使用刚指定的配置项和数据显示图表。
      myChart.setOption(option);
    </script>

  </body>
</html>
</syntaxhighlight>

{{了解更多
|[https://echarts.apache.org/handbook/zh/get-started/ ECharts 手册：快速上手 ]
}}

===配置项===
配置项为[[JSON]]格式，用于声明图表类型、样式、数据和交互。Echarts文档的[https://echarts.apache.org/examples/zh/index.html 示例]中展示了各种配置项。 一个简单的配置项如下：
<syntaxhighlight lang="python">
option = {
  title: {
    text: '折线图示例'
  },
  xAxis: {
    type: 'category',
    data: ['星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日']
  },
  yAxis: {
    type: 'value'
  },
  series: [
    {
      data: [150, 230, 224, 218, 135, 147, 260],
      type: 'line'
    }
  ]
};
</syntaxhighlight>

{{了解更多
|[https://echarts.apache.org/zh/option.html ECharts 配置项]
}}

== 图表类型 ==

== 数据 ==
=== 数据配置 ===
{| class="wikitable"  style="width: 100%;
! 名称
! 描述
! 示例
|-
| dataset
| 数据集（dataset）是专门用来管理数据的组件。 ECharts4开始支持数据集，推荐使用数据集来管理数据，而不是在series的data中设置数据，因为这样数据可以被多个组件复用。这种方式数据和其他配置分离，管理更方便。
|<syntaxhighlight lang="Javascript" >option = {
  legend: {},
  tooltip: {},
  dataset: {
    // 提供一份数据。
    source: [
      ['product', '2015', '2016', '2017'],
      ['Matcha Latte', 43.3, 85.8, 93.7],
      ['Milk Tea', 83.1, 73.4, 55.1],
      ['Cheese Cocoa', 86.4, 65.2, 82.5],
      ['Walnut Brownie', 72.4, 53.9, 39.1]
    ]
  },
  // 声明一个 X 轴，类目轴（category）。默认情况下，类目轴对应到 dataset 第一列。
  xAxis: { type: 'category' },
  // 声明一个 Y 轴，数值轴。
  yAxis: {},
  // 声明多个 bar 系列，默认情况下，每个系列会自动对应到 dataset 的每一列。
  series: [{ type: 'bar' }, { type: 'bar' }, { type: 'bar' }]
};</syntaxhighlight>
|-
| series.data
|
| 
|}
{{了解更多
|[https://echarts.apache.org/handbook/zh/concepts/dataset ECharts 文档：数据集]
}}

=== 数据转换 ===


== 样式 ==

== 交互 ==


==资源==
===官网===
* ECharts 官网：https://echarts.apache.org/
* Echarts 使用手册：https://echarts.apache.org/handbook
* Echarts 示例：https://echarts.apache.org/examples/zh/index.html
* Echarts API：https://echarts.apache.org/zh/api.html
* Echarts 配置项手册：https://echarts.apache.org/zh/option.html

===论文===
* [https://www.sciencedirect.com/science/article/pii/S2468502X18300068 ScienceDirect：ECharts 快速构建基于Web的可视化的声明式框架]

===相关文章===
* [https://zh.wikipedia.org/wiki/Apache_ECharts 维基百科：Apache ECharts]
* [https://pyecharts.org/#/zh-cn/web_django pyecharts 文档：Django 整合]

[[分类:web开发]]