查看“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，在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 获取。


{{了解更多
|[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 文件，一般放入js目录中 -->
    <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 配置项]
}}

==资源==
===官网===
* 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 整合]