ECharts

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

简介

时间轴

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

安装

可以通过下面三种方式安装使用： 1.下载引入。从 https://github.com/apache/echarts/releases 上下载echarts.js，一般放入js目录中，在HTML页面引入即可：

<script src="echarts.js"></script>

2.使用CDN。如从 jsDelivr 引用 echarts。

<script src="https://cdn.jsdelivr.net/npm/echarts@5.2.0/dist/echarts.min.js"></script>

3.从 npm 获取。

npm install echarts --save

了解更多 >> Echarts 文档：获取Echarts Echarts 下载

基础知识

快速上手

使用ECharts基本上为5步：

引入echarts.js文件。
准备一个定义了宽高的DOM容器。
初始化echarts实例。通过调用init()函数。
准备图表配置项。为JSON格式，声明了图表类型、样式、数据和交互。
将配置项设置给echarts实例。通过实例调用setOption()函数。

<!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>

了解更多 >> ECharts 手册：快速上手

配置项

配置项为JSON格式，用于声明图表类型、样式、数据和交互。Echarts文档的示例中展示了各种配置项。一个简单的配置项如下：

option = {
  title: {
    text: '折线图示例'
  },
  xAxis: {
    type: 'category',
    data: ['星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日']
  },
  yAxis: {
    type: 'value'
  },
  series: [
    {
      data: [150, 230, 224, 218, 135, 147, 260],
      type: 'line'
    }
  ]
};

了解更多 >> ECharts 配置项

图表类型

数据

数据配置

名称

描述

示例

dataset

数据集（dataset）是专门用来管理数据的组件。 ECharts4开始支持数据集，推荐使用数据集来管理数据，而不是在series的data中设置数据，因为这样数据可以被多个组件复用。这种方式数据和其他配置分离，管理更方便。

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' }]
};

series.data

了解更多 >> 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

论文

ScienceDirect：ECharts 快速构建基于Web的可视化的声明式框架