ECharts

(重定向自Echarts

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

简介

时间轴

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

了解更多 >> GitHub:Echarts 发布


安装

可以通过下面三种方式安装使用: 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 文档:数据集


数据异步加载

数据转换

样式

交互

资源

官网

论文

相关文章