Apache ECharts is a powerful, interactive charting and data visualization library for browser

Last update: Jan 9, 2023

Overview

Apache ECharts

Apache ECharts is a free, powerful charting and visualization library offering an easy way of adding intuitive, interactive, and highly customizable charts to your commercial products. It is written in pure JavaScript and based on zrender, which is a whole new lightweight canvas library.

中文官网 | ENGLISH HOMEPAGE

Get Apache ECharts

You may choose one of the following methods:

Download from Official Website in 中文下载页
Download from Official Website in English
npm install echarts --save
CDN: jsDelivr CDN

Docs

Tutorial
- 中文
- English
API
- 中文
- English
Option Manual
- 中文
- English

Get Help

GitHub Issues for bug report and feature requests
Email [email protected] for general questions
Subscribe mailing list to get updated with the project

Build

Build echarts source code:

Execute the instructions in the root directory of the echarts: (Node.js is required)

# Install the dependencies from NPM:
npm install

# Rebuild source code immediately in watch mode when changing the source code.
npm run dev

# Check correctness of TypeScript code.
npm run checktype

# If intending to build and get all types of the "production" files:
npm run release

Then the "production" files are generated in the dist directory.

More custom build approaches can be checked in this tutorial: Create Custom Build of ECharts please.

Contribution

If you wish to debug locally or make pull requests, please refer to contributing document.

Resources

Awesome ECharts

https://github.com/ecomfe/awesome-echarts

Extensions

ECharts GL An extension pack of ECharts, which provides 3D plots, globe visualization, and WebGL acceleration.
Liquidfill 水球图
Wordcloud 字符云
Extension for Baidu Map 百度地图扩展 An extension provides a wrapper of Baidu Map Service SDK.
vue-echarts ECharts component for Vue.js
echarts-stat Statistics tool for ECharts

License

ECharts is available under the Apache License V2.

Code of Conduct

Please refer to Apache Code of Conduct.

Paper

Deqing Li, Honghui Mei, Yi Shen, Shuang Su, Wenli Zhang, Junting Wang, Ming Zu, Wei Chen. ECharts: A Declarative Framework for Rapid Construction of Web-based Visualization. Visual Informatics, 2018.

Comments

版本更新出错
One-line summary [问题简述]

重新下载3.7.5版本的包不可以使用报错__DEV__ is not defined 下载最新的，昨天更新的3.8.0 也不可以使用，报错 Path.extend is not a function 好像是echarts更新了，但是zrender没有更新

使用npm install 下载的如果使用以前已经安装好的echarts 3.7.2版本的包是可以使用的，昨天更新把以前的包也改了，都出错了使用webpack进行编译的

Version & Environment [版本及环境]

ECharts version [ECharts 版本]: 3.7.2 3.8.0

Browser version [浏览器类型和版本]: 谷歌

OS Version [操作系统类型和版本]:windows 8

Expected behaviour [期望结果]

恢复以前的3.7.2

新更新的，也要可以使用！！

ECharts option [ECharts配置项]

option = { }

Other comments [其他信息]
opened by lwx466714769 63
How to set bounds for leaflet map?
What problem does this feature solve?

I'm using echarts-leaflet extension in my project. I want to set bounds and making map bounce back if moved away. I can get _map through this.echart.getModel().getComponent('leaflet').__map, but how can I get L and how to setMaxBounds() ?

What does the proposed API look like?

I can set bounds using Leaflet library by using below code :

const southWest = Leaflet.latLng(-89.98155760646617, -180), northEast = Leaflet.latLng(89.99346179538875, 180); const bounds = Leaflet.latLngBounds(southWest, northEast); map.setMaxBounds(bounds);

How can I achieve the same thing using 'echarts-leaflet'?

I tried using below code with echarts-leaflet extension but it's not working.

this.option = { leaflet: { roam: true, maxBounds: [[-89.98155760646617, -180],[89.99346179538875, 180]], maxBoundsViscosity: 1, center: [4.9,-1.766667], zoom: 2, tiles: [{ urlTemplate: 'assets/{z}/{x}/{y}.jpg', options: { minZoom: 2, maxZoom: 6, attribution: '' } }] }

Thanks in advance for any help.
en third-party resolved
opened by eapatel 37

Pie (and other) charts with label going outside of canvas

问题简述 (One-line summary)

Pie charts with sections with long name have the labels that overlap / go out of the canvas (so no more visible)

版本及环境 (Version & Environment)

ECharts 版本 3.2.3:
Chrome 52.0.2743.116 (64-bit):
MAC OS-X El Capitan 10.11.6 (OS Version):

重现步骤 (Steps to reproduce)

Create a pie chart with several sections with long labels (PROBLEM)
Reduce the page size and reload (Same Problem and often overlap)

期望结果 (Expected behaviour)

The labels should stay visible even when they are too long.

可能哪里有问题 (What went wrong)

The labels are not visible and often overlap

ECharts配置项 (ECharts option)

            scope.distributionEvent = {
                identity: $echarts.generateInstanceIdentity(),
                dimension: '10:4',
                config: {
                    tooltip: {
                        trigger: 'item',
                        formatter: "{b} : {c} ({d}%)",
                        zlevel: 2,
                        z: 100
                    },
                    series: [
                        {
                            name: "Event distribution",
                            type: 'pie',
                            radius: ['60%', '70%'],
                            center: ['50%', '55%'],
                            itemStyle : {
                                normal : {
                                    label : {
                                        show : true
                                    },
                                    labelLine : {
                                        show : true,
                                        length: 5
                                    }
                                }
                            },
                            data: [{"name":"New investment","value":6},{"name":"Merger and Acquisition","value":9},{"name":"Bankruptcy","value":3},{"name":"New business relation","value":8},{"name":"Official resignations and appointments","value":1},{"name":"End of activity","value":1},{"name":"New market","value":2},{"name":"New product","value":3},{"name":"New unit","value":1}]
                        }
                    ]
                }
            };

其他信息 (Other comments)

capture d ecran 2016-09-13 a 17 49 07

enhancement priority: high

opened by sbokorna 34

Echarts饼图可以自己设置每个小扇形的半径大小吗？
One-line summary [问题简述]

Version & Environment [版本及环境]

ECharts version [ECharts 版本]:

Browser version [浏览器类型和版本]:

OS Version [操作系统类型和版本]:

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

option = { }

Other comments [其他信息]
opened by 749145134 33
[feature] Support barBorderRadius on the polar bar chart
One-line summary [问题简述]

想给环形图进度条两端设置圆角，但是好像只有柱状图有barBorderRadius属性。

Version & Environment [版本及环境]

ECharts version [ECharts 版本]:

Browser version [浏览器类型和版本]:

OS Version [操作系统类型和版本]:

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

option = { }

Other comments [其他信息]
enhancement
opened by chenxia123 32

echarts tooltip is covered by canvas on iOS13

Version

4.3.0

Steps to reproduce

option ={
                        grid:{
                            top:'20%',
                            bottom:0,
                            right:'5%',
                            left:'0',
                            containLabel:true,
                        },
                        tooltip: {
                            trigger: 'axis',
                            confine:true,
                        },
                        xAxis: {
                            type: 'category',
                        },
                        yAxis:{
                            name:'元/吨',
                            min:'dataMin',
                        },
                        dataset:{
                            dimensions:['日期','采购价'],
                            source:[
                                {'日期':'2019-01-02','采购价':100},
                                {'日期':'2019-01-05','采购价':400}
                            ]
                        },
                        series: {
                            type:'line',
                            smooth:true,
                            symbol: 'circle',
                            symbolSize:2,
                            sampling: 'average',
                            connectNulls:true,
                            label:{
                              // show:true
                            },
                            itemStyle: {
                                color: '#ffc858'
                            },
                            lineStyle:{
                                width:1
                            },
                            areaStyle: {
                                color: new echarts.graphic.LinearGradient(
                                    0, 0, 0, 1,
                                    [
                                        {offset: 0, color: '#ffc858'},
                                        {offset: 1, color: 'rgba(255,200,88,0)'}
                                    ]
                                )
                            }
                        },
                    }

What is expected?

tooltip正常提示

What is actually happening?

tooltip被图形容器遮盖

pending topic: tooltip mobile

opened by collingmk 30

dataview 不能复制和编辑

Hi, 我参照 http://echarts.baidu.com/doc/example/toolbox.html 中的例子重写了dataview的optionToContent函数，dataview显示的内容无法复制，为什么呢？数据和示例中一样可以显示，但不能复制，以下为其他设置： 'dataView': {'show': true, 'readOnly': false, 'title': '详细数据'},

opened by fatflowers 29
SVG renderer / export

It's great that ECharts uses ZRender abstraction to draw stuff into canvas. Makes me thinking how hard would it be to render it as SVG? It doesn't need to support animations, the use case is to download a snapshot of what you see into SVG so it can be potentially printed etc.

Is there any in-memory tree of shapes with calculated positions that can be rendered by something else?
new-feature SVG

opened by jarben 29

echarts.js:3066 Uncaught Error: `setOption` should not be called during main process

One-line summary [问题简述]

用socket.io接收数据并更新option，setoption刷新，有时候会出现错误：echarts.js:3066 Uncaught Error: setOption should not be called during main process。

Version & Environment [版本及环境]

ECharts version [ECharts 版本]: "version": "3.2.3",
Browser version [浏览器类型和版本]:Google chrome 版本 54.0.2840.71 m (64-bit)
OS Version [操作系统类型和版本]:windows 7 61bit

Expected behaviour [期望结果]

了解原因及解决办法。

ECharts option [ECharts配置项]

option = {
               title: {
                    text: '位移'
                },
                tooltip: {
                    trigger: 'axis'
                },
                xAxis: {
                    data:[]/* data.map(function (item) {
                        return item[0];
                    })*/
                },
                yAxis: {
                    splitLine: {
                        show: false
                    },
                    // max:100
                },
                toolbox: {
                    left: 'center',
                    feature: {
                        dataZoom: {
                            yAxisIndex: 'none'
                        },
                        restore: {},
                        saveAsImage: {}
                    }
                },
                // dataZoom: [{
                //     startValue: '2014-06-01'
                // }, {
                //     type: 'inside'
                // }],
                visualMap: [{
                    top: 10,
                    right: 10,
                    pieces: [{
                        // gt: 0,
                        lte: 60,
                        color: '#096'
                    }, {
                        gt: 60,
                        lte: 70,
                        color: '#ffde33'
                    }, {
                        gt: 70,
                        lte: 80,
                        color: '#E9967A'
                    },{
                        gt: 80,
                        color: '#EE0000'
                    }],
                    outOfRange: {
                        color: '#999'
                    }
                }
                ],
                series: {
                    name: 'displacement',
                    type: 'bar',
                    data:[],/* data.map(function (item) {
                        return item[1];
                    }),*/
                    markLine: {
                        silent: false,
                        data: [{
                            yAxis: 60
                        }, {
                            yAxis: 70
                        }, {
                            yAxis: 80
                        }]
                    }
                }
}

Other comments [其他信息]

default

opened by Eddy-CY 28

Enhance funnel chart label display policy

The value of the fan page of the pie chart is less than a certain value. The label and labelLine of this fan page are not displayed.
Funnel plot position increase insideLeft and insideRight attributes.

Add the limitScale parameter under series. Label, and the parameter value is greater than 0 and less than 1. To ensure that the pie chart does not show label and labelLine on the fan page that is less than a certain value.

options={
  title: {
    text: '饼图标题',
    left: 16,
    textStyle: {
      fontSize: 14
    }
  },
  tooltip: {
    trigger: 'item',
    axisPointer: {
      //坐标轴指示器，坐标轴触发有效type: 'shadow'//默认为直线，可选为：'line'|'shadow'
    },
    extraCssText: 'max-width: 300px; word-break:break-all; white-space: normal'
  },
  legend: {
    data: [
      
    ]
  },
  series: [
    {
      type: 'pie',
      label: {
        normal: {
          show: true,
          limitScale: 0.02//小于2%的，不显示
        },
        emphasis: {
          show: true,
          textStyle: {
            fontSize: '14',
            fontWeight: 'bold'
          }
        }
      },
      labelLine: {
        lineStyle: {
          color: '#D9D9D9'
        }
      },
      data: [
        
      ]
    }
  ]
};

opened by cuijian-dexter 26

How to avoid wiggling animation for real-time time series charts?

Version

4.4.0

Steps to reproduce

In our use of echarts I'm facing the behavior shown on this page: https://bost.ocks.org/mike/path/. In older posts the solution was to use addData, but this does no longer exist. We use setOption.

We use the series.data array, with tuples of x/y values.

Is there a suggested way of changing the series data to avoid the wiggling effect?

What is expected?

More a shifting of the time series to the left

What is actually happening?

Animation like in https://bost.ocks.org/mike/path/.
support en stale

opened by klausb 25
[Bug] tooltip.axisPointer.snap:true not working well with sampling: 'lttb'
Version

5.4.1

Link to Minimal Reproduction

https://github.com/jeandet/JS_experiments/blob/2e81d1179781fa30f569fd818d0276d21a9b3def/eCharts/index.html

Steps to Reproduce

Just load the html file and compare tooltip while zoomed or not. Then replace sampling by 'max' for example and repeat.

Current Behavior

When zoomed out tooltip doesn't always show all series values while they have the exact same sampling time, this seems to be due to lttb resampling algorithm. Not sure why it doesn't preserve the same time for each pixel, assuming it only downsample to ~2 values per pixel.

Expected Behavior

Using lttb resampling algorithm shouldn't affect resulting points time and so tooltip should show values for all series when they share the same source sampling rate/time.

Environment

- OS:Linux - Browser:Brave - Framework:

Any additional comments?

The given example fetches data from a public WS.
bug pending en
opened by jeandet 0
[Feature] Ability to load new samples on zoom actions (Zoom in & zoom out)
What problem does this feature solve?

For the time series bar chart, on the initial load, we are displaying data aggregated for every 1 hour. when the user zoom in( for example for 4 hours) we see only 4 samples, instead, can we pull more data from the server which is aggregated for lower interval like 30 or 15 minutes, and display it in the chart when the user zoom in, display higher interval data on the zoom out.

On zoom in display lower interval new data.

On zoom out restore the data which was already available.

What does the proposed API look like?

Whatever make sense for functionality
new-feature pending en
opened by ragava28 0
[Bug] vue项目在ts模式下配置项xAxis.axisLabel. overflow字段报错，请告诉我这是否bug
Version

5.3.3

Link to Minimal Reproduction

No response

Steps to Reproduce

const option: EChartsOption = { xAxis: { axisTick: { show: false }, axisLabel: { color: 'rgba(255,255,255,0.5)', interval: 0, width: 50, overflow: 'none' }, type: 'category', data: [] }, yAxis: { type: 'value', axisLabel: { color: 'rgba(255,255,255,0.5)' }, splitLine: { lineStyle: { color: 'rgba(255,255,255,0.2)', type: 'dashed' } } }, series: [ { data: [], type: 'bar', barWidth: 18 } ] }

Current Behavior

配置字段报错

Expected Behavior

vue项目在ts模式下配置项xAxis.axisLabel. overflow字段报错，请告诉我这是否bug

Environment

- OS: - Browser: - Framework:

Any additional comments?

No response
bug pending
opened by dogker 1

怎样该表图标中文字的样式和对齐方式？

What problem does this feature solve?

这是示例

这是代码

label: {
              show: true, // 图形上的文本标签， 可用于说明图形的一些数据信息， 比如值， 名称等
              fontSize: 12,
              color: '#000', //如果设置为 'inherit'，则为视觉映射得到的颜色，如系列色。
              width: 100,
              overflow: "break", //文字超出宽度是否截断或者换行。配置width时有效
            },

What does the proposed API look like?

这是我找到的API https://echarts.apache.org/handbook/zh/concepts/style

new-feature pending

opened by huluBrother 1

[Feature] 关系图 graph 的 x、y值如何计算出来

What problem does this feature solve?

关系图 graph 的 x、y值如何计算出来，基于什么算法保证每个节点的位置不会出现覆盖的情况。因为业务问题，无法使用 force 布局，求助

What does the proposed API look like?

动态计算x、y值，保证每个节点的位置不会出现覆盖的情况
new-feature pending

opened by Reeyc 1
[Feature] supports action "saveAsImage"
What problem does this feature solve?

Add an action "saveAsImage" for dispatchAction so that you can write code to trigger the saveAsImage event of an echart instance.

What does the proposed API look like?

myChart.dispatchAction({ type: 'saveAsImage', // saveAsImage options ... })
new-feature pending en
opened by TonyYanOnFire 0

Releases(5.4.1)

5.4.1(Dec 9, 2022)
[Feature] [i18n] Add Hungarian(hu_HU) translation. #17978 (ifjkovacsik)

[Feature] [svg] Support gradients and patterns for background color in SVG renderer. #959 (plainheart)

[Feature] [candlestick] Provide borderColorDoji option for custom doji color. #17717 (Ovilia)

[Feature] [sankey] Support edgeLabel. #16767 (susiwen8)

[Feature] [graph] Make graph node draggable in none and circular layout. #15428 (kongmoumou)

[Feature] [util] Use native Map if available. #965 (JonasBa)

[Feature] [type] Export ECElementEvent for TypeScript. #17892 (keita-determined)

[Fix] [i18n] Rename language code of Ukrainian to UK. #17812 (striezel)

[Fix] [pie] Fix percent isn't updated after the legend is changed. #17734 (plainheart)

[Fix] [pie] Fix potential null access to labelLine when minShowLabelRadian is set. #17715 (plainheart)

[Fix] [pie] Fix center may not be converted to correct point when coordinate system is specified. #17920 (plainheart)

[Fix] [heatmap] Fix heatmap label may overlap when dataZoom is enabled. #17876 (plainheart)

[Fix] [animation] Fix incorrect dataGroupId for old data items in universalTransition. #17559 (tyn1998)

[Fix] [dataZoom] Fallback to extent start/end when value or percent is invalid. #17934 (plainheart)

[Fix] [timeline] Fix chart can't work when axis line is not shown. #17647 (plainheart)

[Fix] [tooltip] Fix tooltip arrow may cover the content when border is wide. #17875 (plainheart)

[Fix] [marker] Fix markArea doesn't show when using x/y pixel but coord is not defined. #17217 (jiawulin001)

[Fix] [marker] markArea of bar series now covers whole specified categories. #17098 (jiawulin001)

[Fix] [legend] Fix legend inverse doesn't work if series data have the same name. #17510 (caiwukun)

[Fix] [gauge] Render gauge sectors in the order of the "clockwise" option. #17691 (ZeekoZhu)

[Fix] [ssr] Fix wrong expression for extracting the font size. #968 (plainheart)

[Fix] [svg] Fix shape may disappear after morphing animation is finished in SVG renderer. (plainheart)

[Fix] [type] Fix EChartsInitOpts type error about height and width. #17727 (MainHou)

[Fix] [type] Add overflow property to AxisLabelBaseOption interface. #17808 (breizh24)

[Fix] [type] Add string & number type into the center option of pie series. #17917 (plainheart)

[Fix] [type] Add missing function callback into lineStyle.color for lines series. #17780 (plainheart)

Source code(tar.gz)
Source code(zip)
5.4.1-rc.1(Dec 1, 2022)

Release 5.4.1-rc.1
Source code(tar.gz)
Source code(zip)
5.4.0(Sep 25, 2022)
[Feature] Support intelligent pointer snapping. #17102 (Ovilia)

[Feature] [pie] Support specifying coordinate system for pie series. #17132 (plainheart)

[Feature] [gauge] Support rotation for axisLabel. #16985 (MeetzhDing)

[Feature] [lines] Support going back for effect animation. #16943 (wangguisong)

[Feature] [treemap] Support emphasis state for breadcrumb. #17242 (susiwen8)

[Feature] [i18n] Add Ukrainian(uk-UA) translation. #17244 (Amice13)

[Feature] [type] Export type ElementEvent. #15291 (Map1en)

[Fix] [pie] Fix labelLine may not be hidden when minShowLabelRadian is specified. #17412 (plainheart)

[Fix] [pie] Optimize performance of pie series. #17275 (wind108369)

[Fix] [line] Set default z/zlevel for temporary symbol to avoid warnings. #17247 (plainheart)

[Fix] [bar-race] Fix lines glitch with sub-pixel optimization in animations. #17426 (Ovilia)

[Fix] [axis] Fix inverse option does not work for singleAxis. #17411 (wind108369)

[Fix] [axis] Fix axis symbol is not reversed when axis is reversed. #17329 (plainheart)

[Fix] [state] [emphasis] Fix emphasis.scale can't be reset and specified values may not be respected. #17442 (plainheart)

[Fix] [state] [emphasis] Add missing type number to emphasis.scale for scatter/line/graph series. #17390 (plainheart)

[Fix] [svg] Encode HTML special characters when generating SVG string. #17406 (plainheart)

[Fix] [visualMap] Fix the indicator doesn't show when hovering on map label. #17346 (plainheart)

[Fix] [custom] Fix elements may not be removed after updates. #17349. (Ovilia)

[Fix] [custom] Fix custom elements probably can't be removed when applying leave transition. #17308 (plainheart)

[Fix] [theme] Fix text style of tooltip in macarons theme. #17551 (mousne)

[Fix] [theme] Fix abandoned normal level in theme files. #17482 (Liangism)

[Fix] [axis] [log] Fix log axis breaks a single data whose log value is negative. #17322 (Ovilia)

[Fix] [dataZoom] Fix errors when using sliderZoom in candlestick series with dataset. #17237 (jiawulin001)

[Fix] [sunburst] Fix wrong log for deprecated action. #17587 (gitforhlp)

[Fix] [type] Ensure compatibility with TypeScript 4.8. #17582 (AviVahl)

[Fix] [type] Add missing value type false for nodeClick option for SunburstSeriesOption and TreemapSeriesOption. #17218 (dmzc)

[Fix] [typo] Fix a file name typo. src/animation/basicTrasition.ts → src/animation/basicTransition.ts #17193 (kxxoling)

Source code(tar.gz)
Source code(zip)
5.4.0-rc.1(Sep 13, 2022)

Source code(tar.gz)
Source code(zip)
5.3.3(Jun 14, 2022)
[Feature] [bar] add new stacking strategies. #17086 (villebro)

[Feature] [tree] tree focus supports relative. #17009 (susiwen8)

[Feature] [visualMap] selectedMode supports boolean. #16972 (susiwen8)

[Feature] [graph] [tree] [map] series center of view supports string. #16904 (susiwen8)

[Fix] [line] fix polygon not being updated when switching from line chart to step line chart with notMerge: true. #16772 (jiawulin001)

[Fix] [tree] fix radial tree with a single root not working. #16950 (fuchunhui)

[Fix] [tree] fix unexpected expanded children when edgeShape is polyline. #16548 (linghaoSu)

[Fix] [graph] fix user cursor setting not being respected. #16867 (susiwen8)

[Fix] [graph] fix autoCurveness type. #16897 (kongmoumou)

[Fix] [radar] fix names being - in tooltip when name.show is false. #15985 (Ovilia)

[Fix] [radar] fix regression bug brought by branch merging. #16764 (plainheart)

[Fix] [geo] fix linesGL series not render. #17150 (plainheart)

[Fix] [pictorialBar] improve PictorialBarSeriesOption type definition. #17155 (dmzc)

[Fix] [tooltip] fix content changes with axis extent when 'triggerOn' set to 'click'. #16939 (jiawulin001)

[Fix] [dataZoom] fix borderColor may not work in some bundle environments. #16854 (Ling310)

[Fix] [markLine] fix markLine label showing wrong tooltip content. #16971 (plainheart)

[Fix] [markArea] fix markArea may be filtered unexpectedly. #16861 (jiawulin001)

[Fix] [axis] fix {yy} not being padded to 2 digits. #17064 (Fritzbox2000)

[Fix] [axis] fix quarters splitting the year into 4 quarters not 3. #17073 (Fritzbox2000)

[Fix] [axis] fix custom series not working on singleAxis. #16850 (benlongo)

[Fix] [graphic] fix some options may be unexpectedly reset on update. #17007 (plainheart)

[Fix] [decal] fix pattern not changing after set legend.itemStyle.decal to be 'none'. #16922 (jiawulin001)

[Fix] [radialGradient] add safe guarding for radial gradient. #898. #919 (lefex) (Ovilia)

[Fix] [types] fix typo in DataStore. #16824 (XXXMrG)

Source code(tar.gz)
Source code(zip)
5.3.3-rc.1(Jun 10, 2022)

Release 5.3.3-rc.1
Source code(tar.gz)
Source code(zip)
5.3.2(Apr 1, 2022)
[Feature] [line] allow areaStyle.origin to take number as input. #16719 (jiawulin001)

[Feature] [scatter] scale support number. #16688 (susiwen8)

[Feature] [tree] add collapsed to tree click event parameters. #16660 (susiwen8)

[Fix] [marker] fix marker state doesn't restore after blurring. #16670 (susiwen8)

[Fix] [gauge] fix progress bar may become unexpectedly circle when value is 0 and progress.roundCap is enabled. #16653 (plainheart)

[Fix] [polar] fix chart throws errors when splitLine is enabled in radius axis. #16736 (plainheart)

[Fix] [labelLine] fix labelLine can't be hidden. #16542 (susiwen8)

[Fix] [dataZoom] fix dataZoom was unexpectedly displayed at the top when data contains null values. #16730 (yuanjiangxia)

[Fix] [heatmap] fix unexpected gaps in heatmap charts. #16714 (plainheart)

[Fix] [toolbox] fix toolbox title may be outside of the chart. #16704 (plainheart)

[Fix] [toolbox] toolbox doesn't enter emphasis state when hovering on the icon. #16702 (plainheart)

[Fix] [toolbox] [dataview] fix unexpected scrollbar and outline when using default textview. #16691 (plainheart)

[Fix] [visualMap] fix some text style can't work on visualMap. #16679 (fuchunhui)

[Fix] [line] fix line graph renders null value incorrectly. #16672 (WindyZ99)

[Fix] [sanky] fallback to black if color is illegal. #16614 (susiwen8)

[Fix] [types] fix wrong jpg instead of jpeg image export types. #16747 (yassilah)

Source code(tar.gz)
Source code(zip)
5.3.2-rc.1(Mar 28, 2022)

Release 5.3.2-rc.1
Source code(tar.gz)
Source code(zip)
5.3.1(Mar 7, 2022)
[Feature] [i18n] Add korean translation #16582 (hijae)

[Feature] [heatmap] Add borderRadius option to heatmap. #16493 (Rain120)

[Fix] [lines] Fix potential memory leak in the effect line when setOption with notMerge. #16525 (pissang)

[Fix] [line] Fix stepped line charts with empty data. #16435 (Gyyi)

[Fix] [line] Fix empty data in lttb sampling. #16431 (fuchunhui)

[Fix] [tooltip] Changing default time formatter to be in 24-hour format. #16421 (Comee)

[Fix] [graphic] Fix cursor doesn't work in graphic component. #16513 (plainheart)

[Fix] [pictorialBar] Fix pictorialBar data with value of 0. #16469 (fuchunhui)

[Fix] [svg] Fix render bug when using decal. #889 (pissang)

[Fix] [tooltip] Fix legend.tooltip.enterable and tooltip.enterable. #16463 (fuchunhui)

[Feature] [event] Provide label index in axis events #16187 (Ovilia)

[Fix] [sunburst] Centering labels of sunburst at the first level. #16425 (FrankChencc)

[Fix] [tooltip] Hide tooltip when data view is open. #16321 (plainheart)

[Fix] Fix sampling with zero width charts. #16372 (Cuiyansong)

Source code(tar.gz)
Source code(zip)
5.3.1-rc.1(Mar 2, 2022)

Release 5.3.1-rc.1
Source code(tar.gz)
Source code(zip)
5.3.0(Jan 26, 2022)
[Feature] Introduce new keyframe based animation to graphic component and custom series. #16225 (pissang)

[Feature] Support transition animation in the graphic component. #16225 (pissang)

[Feature] [svg] Refactor SVG renderer. Improved SVG rendering performance by 2x ~ 10x. #836 (pissang)

[Feature] [svg] Add SVG server-side rendering with zero dependencies. #15880 (pissang)

[Feature] [axis] Add alignTicks for mutliple axis alignment. #16300 (pissang)

[Feature] [state] Add select.disabled to disable select state. #15534 (susiwen8)

[Feature] [state] Add selectedMode: 'series' to select the whole series. #15534 (susiwen8)

[Feature] [state] Add emphasis.disabled to disable emphasis state. #16368 (pissang)

[Feature] [map] Introduce projection to map series and geo component. #16364 (pissang)

[Feature] [geo] Support LineString and MultiLineString in GeoJSON source. #16364 (pissang)

[Feature] [tooltip] Add valueFormatter in the tooltip. #16332 (pissang)

[Feature] [pie] [sunburst] Supports configuring radius on the four corners of sector. #16298 (plainheart)

[Feature] [i18n] Add Italian translation. #16211 (andrearoota)

[Feature] [i18n] Add Romanian translation. #15990 (szilard-dobai)

[Fix] [graph] Fix error when symbol is none. #16394 (pissang)

[Fix] [dataset] Fix sourceHeader: false may not work. #16376 (lefex)

[Fix] [tooltip] Fix the page will be frozen if multiple tooltips are provided. #16347 (plainheart)

[Fix] [bar] Optimizing bar layout in the large mode. Fix stacked bar when large is enabled. #16338 (pissang)

[Fix] [bar] Fix stacked bar on the log axis. #16338 (pissang)

[Fix] [pie] Optimize label layout and text wrapping #16034 (Ovilia)

[Fix] [polar] Fix edge symbols are clipped unexpectedly for the tiny offset. #16329 (plainheart)

[Fix] [map] Fix some labels won't be shown when legend is enabled and no label formatter specified. #16322 (plainheart)

[Fix] [pie] Fix tangential rotation with startAngle. #16307 (Ovilia)

[Fix] [graph] Support using dataType param to highlight edge by dispatchAction. #16243 (Dingzhaocheng)

[Fix] [pie] Fix label of first sector may not shown. #16229 (116050423)

[Fix] [tooltip] Fix tooltip lagging when transition is disabled. #16212 (plainheart)

[Fix] [axis] Fix axis label width not affect the grid layout. #16203 (Ovilia)

[Fix] [lines] fix NPE issue when lines series has no coordinate system. #16184 (plainheart)

[Fix] [line] Fix using endLabel may throw excpetion when series is totally filtered. #16339 (pissang)

[Fix] [dataZoom] Optimize shadow render performance when dragging on the chart. #16070 (pissang)

[Fix] [line] Fix bezier points calculated wrong when monotone smooth is used. #16069 (pissang)

[Fix] [line] Fix tooltip not shown when all values are null #16001 (kongmoumou)

[Fix] [axis] Fix scale on the log axis. #15998 (susiwen8)

[Fix] [radar] Fix tooltip displayed wrong when name.show is false. #15985 (Ovilia)

[Fix] [progressive] Optimize progressive rendering performance #15870 (pissang)

[Fix] [svg] Fix rect path can't be closed bug.

[Fix] [svg] Normalize color when using SVG renderer to support more cases. #767 (plainheart)

[Fix] [pictorialBar] Fixed incorrectly display when data is 0 and border is used. #12793 (yanheSu)

[Fix] [map] Optimize default label position calculation. Use centroid of the largest area. #16364 (pissang)

[Fix] [animation] Fix opacity may be wrong when set divideShape: 'clone' in the universal transition #16250 (pissang)

[Fix] [bar] Optimize morphing on the bar with rounded cap. #16246 (pissang)

Add .js extension in the import statement #16276 (pissang)

Source code(tar.gz)
Source code(zip)
5.3.0-rc.1(Jan 23, 2022)

Source code(tar.gz)
Source code(zip)
5.2.2(Nov 1, 2021)
[Feature] [line] Add triggerLineEvent. Support trigger mouse event on polyline and polygon area. #15847 (susiwen8)

[Feature] [i18n] Add Russian translation. #15867 (finkrer)

[Feature] [i18n] Add Polish translation. #15891 (CaelumNigre)

[Fix] [line] fix smoothed line with duplicate points failed to draw #15942 (pissang)

[Fix] [line] Fix visual gradient is wrong when coords are between two stops. #15938 (pissang)

[Fix] [calendar] Fix i18n doesn't work in the calendar coordinate system #15935 (plainheart)

[Fix] [bar] Fix label value animation is not accurate in the bar racing case. #15916 (Ovilia)

[Fix] [axis] fix charts render abnormally when yAxis.max is set to be a value less than the min value of the series data. #15878 (plainheart)

[Fix] [tooltip] Fix boolean value display. #15869 (Ovilia)

[Fix] [types] Add undefined to the return type of getInstanceByDom and getInstanceById #15913 (plainheart)

Source code(tar.gz)
Source code(zip)
5.2.2-rc.1(Oct 27, 2021)

Source code(tar.gz)
Source code(zip)
5.2.1(Sep 21, 2021)
[Feature] [i18n] Adding pt-BR (Portuguese, Brazil) lang. #15722 (williamorim)

[Feature] [axis] add axisLabel.hideOverlap. #15583 (svedova) #15712 (pissang)

[Feature] [sunburst] Add radius in levels #15706 (Ovilia)

[Fix] [line] Fix animation may be wrong when data changes lot. #15731 (pissang)

[Fix] [legend] Fix icon not keep aspect. #15720 (pissang)

[Fix] [line] Optimize line gradient leaks on the edge when the range is large. #15711 (pissang)

[Fix] [marker] Fix markLine, markPoint and markArea may not work on time axis if use string time data #15686 (100pah)

[Fix] [tooltip] Fix tooltip may be lagging and shaking in Chrome(with the devtools open) and Firefox. #15683 (plainheart)

[Fix] [svg] Fix svg mouse event doesn't work normally in Firefox when using shadow. #812 (plainheart)

[Fix] [line] Not stop existing expand animation when update. #15599 (Ovilia)

[Fix] [geo] Fix href attribute not work in SVG source. #803 (plainheart)

[Fix] [polar] Fix wrong sector clockwise when previous data is 0. #15589 (Ovilia)

[Fix] [type] Improve option types. #15696 (pissang)

[Fix] Fix prototype pollution. GHSA-fhv8-fx5f-7fxf

Source code(tar.gz)
Source code(zip)
5.2.1-rc.1(Sep 17, 2021)

Source code(tar.gz)
Source code(zip)
5.2.0(Sep 1, 2021)
v5.2.0

Break Changes

[Fix] [pie] Negative value will be filtered #15095 (ssthouse)

All Changes

[Feature] Introduce universal transition to all series. #15208 (pissang)

[Feature] [color] Add series.colorBy #13788 (Ovilia)

[Feature] [label] Support sector label positions for polar bars #774 (Ovilia)

[Feature] [effectScatter] Add rippleEffect.number #15335 (plainheart)

[Feature] [gauge] Add pointer.showAbove to allow pointer show above the title and details. #15337 (AmosChenYQ) #15326 (susiwen8)

[Feature] [emphasis] emphasis.color can use 'inherit' to be not higlighted. #15172 (Foreverwzh)

[Feature] [pie] Display an empty cicle when pie don't have value. #15095 (ssthouse)

[Fix] [dataset] Fix dataset performance drops signifcantly on high dimensions data. #15355 (pissang)

[Fix] [axis] Optimize format in time axis #15465 (leavest) #15434 (zhiyuc123)

[Fix] [custom] Optimize text font compatibility with legacy code. #15454 (AmosChenYQ)

[Fix] [memory] Optimize memory when chart instance is still hold after dispose #15417 (pissang)

[Fix] [line] Optimize color gradient when having infinite value. #15416 (plainheart)

[Fix] [date] Optimize date parsing #15410 (quillblue)

[Fix] [line] Fix render bug. #788 (pissang)

[Fix] [candlestick] Fix style lost after update #15368 (pissang)

[Fix] [sankey] Gradient should follow orient. #15363 (susiwen8)

[Fix] [tooltip] Fix tooltip formatter doesn't renders HTMLElement if tooltip position is specified. #15313 (plainheart)

[Fix] [tooltip] Tooltip should clear content when formatter returns null. #15313 (plainheart)

[Fix] [bar] Set label to be inside when position is 'middle' #15309 (Ovilia)

[Fix] [marker] Fix 'clampData' undefined error in 'getMarkerPosition' #15297 (AmosChenYQ)

[Fix] [treemap] Fix old nodes not removed when disabled animation #15283 (villebro)

[Fix] [tree] Fix edge may not removed when update data #15251 (ssthouse)

[Fix] [pie/sunburst] Fix borderRadius can't be reset in pie series and sunburst series when setting it to null or undefined #15243 (plainheart)

[Fix] [canvas] Fix unexpected none or null fillStyle may be warned in firefox #784 (plainheart)

[Fix] [highlight] Hightlight multiple series through chart.dispatchAction not work as expected #15207 (ssthouse)

[Fix] [sankey] Fix drag bug when using series.nodes to represent data. #15199 (DuLinRain)

[Fix] [svg] Optimize exported SVG compatibility for Powerpoint. #767 (plainheart)

[Fix] [legend] Fix text.lineHeight not work #773 (ssthouse)

[Fix] [pie] Change the default borderJoin to round. #15145 (plainheart)

[Fix] [radar] Change the default borderJoin to round. #15381 (Ovilia)

[Fix] [treemap] Fix label.show set to false will throw error #15141 (susiwen8)

[Fix] [pictorialBar] Fix pictorialBar zero value label display. #15132 (ssthouse)

[Fix] [lines] Fix lines can't be cleared by chart.clear() #15088 (plainheart)

[Fix] [endLabel] Fix endLabel not display when only set emphasis.show to true. #15072 (Ovilia)

[Fix] [svg] Fix rect path not closed. #767 (plainheart)

[Fix] [treemap] Add treeAncestors in callback params #14976 (pissang)

[Fix] [tree] Fix error when running setOption twice with different data #14930 (Map1en)

[Fix] [radar] Fix radar symbol border is scaled #15396 (pissang)

[Fix] [marker] Fix symbolOffset and symbolKeepAspect doesn't work in markPoint. #14737 (plainheart)

[Fix] [gauge] Fix data index and series index is missing. #14688 (yufeng04)

[Fix] [tooltip] Tooltip arrow will follow borderWidth. #14393 (g7i)

[Fix] [geo] Fix geo switch from hidden to show fail. #15361 (pissang)

[Fix] [type] Optimize type of renderItem in custom series.

[Fix] [type] Optimize option type of echarts.init. #15487 (John60676)

[Fix] [type] There is no polarIndex when coordinate of series is polar #15281 (Map1en)

[Fix] [type] Optimize type when using SVG source in geo component. #15263 (leosxie)

[Fix] [type] Fix wrong type for pie data and map data. #15144 (plainheart)

Source code(tar.gz)
Source code(zip)
5.2.0-rc.1(Aug 28, 2021)

Source code(tar.gz)
Source code(zip)
5.1.2(Jun 8, 2021)
v5.1.2

[Feature] [geo/map] Support skew in transform and svg parser. #755 (pissang)

[Feature] [tree] Add treeAncestors property in the params of tooltip callback . #14957 (stephenLYZ)

[Feature] [i18n] Add Slovenian translation. #14758 (dkrat7)

[Fix] [canvas] Fix extra ctx.save call when dirty rect is enabled. #765 (pissang)

[Fix] [path] Fix small subpath may be ignored when optimizing small line segments. #760 (pissang)

[Fix] [tooltip] When component tooltip.formatter is not specified, use a specific default formatter, rather than use global tooltip.formatter as default. Fix #14939. #14972 (100pah)

[Fix] [resize] Error thrown when resize is called after setOption called with lazyUpdate: true. Fix #14846, Fix #11395. #14934 (100pah)

[Fix] [treemap] Error when running setOption twice with diff data. #14930 (Map1en)

[Fix] [tree] Error when running setOption twice with diff data. #14905 (Map1en)

[Fix] [option] Check the missing component before merge theme. #14966 (pissang)

[Fix] [text] Fix gradient text background cause rendering error. #756 (pissang)

[Fix] [clip] Line chart will throw an error when clip is set as false. #14813 (plainheart)

[Fix] [legend] Remove unexpected syntax to ensure better compatibility. #14810 (plainheart)

[Fix] [dataZoom] Type fix for startValue and endValue. Close #14412 #14775 (dileepyelleti)

[Fix] [label] Ensure the label of the temporary symbol is in front of line and area polygon. #14993 (plainheart)

[Fix] [stack] Fix number getPrecisionSafe incorrect on scientific notation like 3.45e-1. Stack sum eliminate floating arithmetic problem. #15015 (100pah)

[Fix] [dataZoom] Should no dataZoom filtering when toolbox.feature.dataZoom not declared. #15015 (100pah)

[Fix] [line] Avoid the infinite value in linearMap util. #14602 (plainheart)

[Fix] [timeline] Trigger timelineplaychange event when play to the end. #14620 (Ovilia)

[Fix] [custom] Fix progressive rendering in custom series. #14920 (pissang)

[Fix] [brush] Clamp range when brush. #14569 (susiwen8)

[Fix] [label] Fix labels are not on the top bug. #14542 (plainheart)

[Fix] [toolbox] The show option of customized toolbox button does not work. #14408 (plainheart)

[Fix] [type] Changed LineEndLabelOption.valueAnimation to be optional. #14806 (Bilge)

[Fix] [type] Export cbs and their parameter types. #14871 (dougalg)

[Fix] [type] Fix position callback return type. Fix #15031. (congjiujiu)

[Fix] [type] Remove non-required properties from PatternObject and fix some type issues. #759. (plainheart)

Source code(tar.gz)
Source code(zip)
5.1.2-rc.1(Jun 4, 2021)

Source code(tar.gz)
Source code(zip)
5.1.1(Apr 27, 2021)
[Fix] [geo] Fix tooltip don't show on geo component. #14767 (pissang)

[Fix] [tooltip] Fix the position of tooltip may be incorrect when appendToBody. #14713 (plainheart)

[Fix] [map] Fix tooltip may have error on map series. #14704 (plainheart)

[Fix] [pie] Fix labelLine may still appear on emphasis when changed from outside to inside. #14702 (villebro)

[Fix] [type] Fix type error on earlier TypeScript versions. Close #14716 #14739

[Fix] [type] symbolOffset incorrectly marked as mandatory. #14693 (villebro)

Source code(tar.gz)
Source code(zip)
5.1.1-rc.1(Apr 23, 2021)

Source code(tar.gz)
Source code(zip)
5.1.0(Apr 16, 2021)
v5.1.0

!![Feature] [geo] [map] geo component and map series support SVG format source. #14571 (100pah)

![Feature] [legend] Default legend design is more intuitive. #14497 (Ovilia)

[Feature] [i18n] Add czech translation #14468 (JiriBalcar)

[Feature] [animation] Add animaiton configuration in resize #14553 (pissang)

[Feature] [effectScatter] Add clip for effectScatter #14574 (susiwen8)

[Fix] [debug] Optimize error log when components or series are missing #14568 (pissang)

[Fix] [tooltip] Improve the performance of tooltip. #14246 (plainheart)

[Fix] [label] Fix labels may have wrong z and not in the front. #14542 (plainheart) #14417 (susiwen8)

[Fix] [pattern] Fix CanvasPatttern#setTransform may not exists error. #738 (pissang)

[Fix] [tooltip] Fix formatter wrong when using time axis #14471 (Ovilia)

[Fix] [symbol] Make symbolOffset work on all the components using symbols. #14375 (plainheart)

[Fix] [markArea] Fix markArea background color disappeared bug. Close #13647 #14343 (Nick22nd)

[Fix] [markLine] Fix string type data may not work in markLine. Close #14300 #14314 (Ovilia)

[Fix] [select] Fix null access bug when checking selected status. Close #14293 #14413 (leosxie)

[Fix] [dataZoom]fix dataZoom setting no effect #14388 (wf123537200)

[Fix] [animation] Fix animation between NaN value may have problem. #730 (Nick22nd)

[Fix] [visualMap] Use itemSymbol as default symbol type. Close #5719 #14243 (Ovilia)

[Fix] [loading] Fix text of loading is not in the front and covered by others. #14191 (yufeng04)

[Fix] [custom] Fix series label on custom series not working properly. Close #14092 #14254 (Nick22nd)

[Fix] [map] Fix map labels won't update its position when labelLayout is used. #14578 (pissang)

[Fix] [calendar] Fix day label drifting. Close #11508 #13902 (Nick22nd)

[Fix] [lines] Fix line animation may have extra points and being messed up. #13638 (vially)

[Fix] [type] Exporting more necessary types for generating declarations in the extensions #14289 (pissang)

[Fix] [type] Add LegendComponentOption.icon property type #14263 (thesiti92)

[Fix] Remove legacy usage of transform #14357 (pissang)

Source code(tar.gz)
Source code(zip)
5.1.0-rc.1(Apr 12, 2021)

Source code(tar.gz)
Source code(zip)
5.0.2(Feb 6, 2021)
v5.0.2

2021-02-06

[Fix] [dataZoom] Fix icon with 'image://' won't display #14056 (susiwen8)

[Fix] [pie] [gauge] Fix zero value sector may be incorrectly drawn as a circle. #699 (plainheart)

[Fix] [pie] Fix hiding wrong labels in pie. #14108 (Nick22nd)

[Fix] [map] Add geo as dependency in map. #14124 (pissang)

[Fix] [labelLine] Fix labelLine will not been hidden when label is switched from outside to inside #14017 (susiwen8)

[Fix] [toolbox] Fix yAxisIndex: false in toolbox dataZoom may have error. #14175 (100pah)

[Fix] [toolbox] Fix image download may have error when not using default pixelRatio. #706 (plainheart)

[Fix] [toolbox] Use current devicePixelRatio by default for exporting crisp and clear images by default. #14002 (plainheart)

[Fix] [line] endLabel color support 'auto' 'inherit' #14000 (susiwen8)

[Fix] [svg] fix opacity may not work in SVG renderer. #675 (plainheart)

[Fix] [type] Optimize event param types #14155 (pissang)

Source code(tar.gz)
Source code(zip)
5.0.2-rc.1(Feb 1, 2021)

Source code(tar.gz)
Source code(zip)
5.0.1(Jan 16, 2021)
v5.0.1

[Feature] New minimal import API. Improved exported option types. #13890 (pissang)

[Fix] [tooltip] Fix tooltip of markPoint is wrong #13992 (susiwen8)

[Fix] [loading] Fix showLoading center align and fontSize not work. Add fontFamily, fontWeight, fontStyle #13972 (yufeng04)

[Fix] [gauge] pointer.offsetCenter doesn't work without icon #13966 (yufeng04)

[Fix] [dataset] Fix automatic legend from dataset is wrong. #13930 (100pah)

[Fix] [handler] Fix tooltip can't be hidden when moving out of the viewport occasionally. #693 (pissang)

[Fix] [tooltip] Fix text color can't be changed in tooltip. #13848 (susiwen8)

[Fix] [tooltip] Fix borderColor can't be changed in tooltip. #13771 (susiwen8)

[fix] [axis] Fix error when category axis max is greater than data length #13733 (Ovilia)

[fix] [svg] Fix chart cannot be exported with SVG renderer in IE. #13732 (plainheart)

[Fix] [bar] Improvement and some fixes of bar race chart #13994 (100pah)

[Fix] Fix unexpected global name usage, which may have error in other environments. #13984 (pissang)

Source code(tar.gz)
Source code(zip)
5.0.1-rc.1(Jan 12, 2021)

Source code(tar.gz)
Source code(zip)
5.0.0(Dec 2, 2020)
v5.0.0

Migrate codebase to TypeScript:

The entire code base have been migrated to TypeScript.

Provide types/dist/echarts.d.ts for the upper TS based applications, where the TS version supported is down to 3.4.

See more details in #13563

[Feature] States enhancement:

Support state transition animation, which brings better interaction effect when highlighting or downplaying some part of the chart.

Besides the state "emphasis" we already have, v5.0 provides two more configurable state: "select" and "blur" in all series. The option of them are the same as the existing "emphasis". "blur" is used the elements need to fade out when focusing some other elements. "select" is used when the element is selected by mouse/touch click or API triggering.

Support to blur other graphic elements when highlighting specified data through mouseover or hover linking. See examples bar-label-rotation, bar-polar-stack, bar-stack, area-stack, dataset-link, scatter-weight, tree-basic.

Unify the previous different state configurations in series, like highlightPolicy, focusNodeAdjacency, hoverOffset, by the option focus, blurScope and scale. See examples sankey-energy, graph, sunburst-drink.

See more details in #12925 and #12911.

[Feature] Provide a more powerful label support:

Use some strategies to bring better displayed labels, including:

Smarter text color strategy to make labels more easy to be distinguished from different background.

Smarter label layout in pie chart, especially when there are too many labels or insufficient space. And related issue: #6050.

Provide more overflow configurations.

Provide option set labelLayout to enable more abilities for developers to tweak the layout of the labels after it's originally positioned by the chart itself. With the options in labelLayout, developers can:

Avoid labels overlap (see scatter-label-align-right),

Make special label alignment, and adjust label position, etc.. See the examples pie-alignTo, pie-labelLine-adjust, pie-label-distanceToLabelLine, pie-label-bleedMargin.

Make label draggable.

Support labelLine for all series, which is very useful for guiding element to related labels when labels have to be far away from the elements. See examples scatter-label-align-right, scatter-label-align-top. Related issues: #11534, #12971.

See more details in #12911.

[Feature] Chart racing, bar realtime sorting and label animation:

Bar race and line race is a popular way to show time series data, and visualize the change in trends over time.

We provide this capability by bar sorting (series.sort and series.realtimeSort) and end label animation (series.label.valueAnimation, series.endLabel). And this individual options can be used in other related scenarios.

See examples bar-race, and see more details in the original pull request #12484, #13246 and #13045.

Other the racing of some special customized chart can be implemented by custom series and the callback of renderItem during. See the example custom-spiral-race, and see more details in #12775.

[Feature] Support data transform plug-in:

Data transform is a new set of configurations and APIs to enable data transformation based on dataset in declarative way. Built-in or third-party data transformer can be made as plug-ins to provide various transform algorithms. ECharts users can use those transformers in ECharts option.

See examples data-transform-filter, data-transform-sort-bar, data-transform-multiple-pie, doc-example/data-transform-multiple-sort-bar, boxplot-light-velocity, bar-histogram, scatter-clustering, scatter-exponential-regression, scatter-linear-regression, scatter-logarithmic-regression, scatter-polynomial-regression. See more details in #13065, #13127](https://github.com/apache/incubator-echarts/pull/13127).

[Feature] Provide more smarter time axis label and tick arrangement:

See more details in #12859.

[Feature] Support decal:

Decal provides a new visual type that does not only augment aria scenarios but also enrich visual effects.

See more details in #13304.

[Feature] Provide custom series animation configuration in transform, style, shape morphing/combining/separating.

See examples custom-combine-separate-morph, custom-one-to-one-morph, custom-story-transition, custom-spiral-race, custom-gauge.

See more details in #12775, #13468, #13271.

[Feature] Provide a more powerful gauge:

See examples gauge-barometer, gauge-clock, gauge-multi-title, gauge-progress, gauge-ring, gauge-grade, gauge-simple, gauge-temperature.

See more details in #13416.

[Feature] The default theme and interaction have been greatly enhanced. Some new options are provided for the style and interaction configuration:

Tooltip style enhancement: #12947, #13398, #13242.

Provide configurable dash style: #12961.

Axis style enhancement: #13046.

DataZoom support both brush and drag: #13025.

Support darkMode. 12911.

Enhance resize & dataZoom animation: #12965

Change the closing direction of a single bar, #12543.

Enhance pie chart animation #12553.

Other component style enhancement: #13008, #13013.

[Feature] Make i18n registerable and change the product.

Build: #13038.

Japanese: #13470.

German: #13315.

French: #13056.

FI/ES/TH: #13055.

[Feature] Support rounded corner in pie and sunburst:

See #13390 and #13378.

[Feature] Make tooltip more configurable:

Support to add CSS class to tooltip. #13383.

Support to return DOM in tooltip formatter. #13469.

[Feature] Support to partially remove components or replace components:

See details in #12987.

[Enhancement] Enhance performance in some scenarios:

Improve large line performance, and support data sampling in largest-triangle-three-buckets algorithm.

See more details in #13314, #13317, #13337.

Fix issues #12249, #10200, #4556.

Support dirty rect: #13170

Others: #13339.

Other small features, enhancements and bug-fixes:

[Feature] Enhance parseDate #13044.

[Feature] Make line bolder when line is in emphasis state #13013.

[Feature] Sankey supports lineStyle: {color: 'gradient'}.

[Feature] markPoint.data.type and markArea.data.type support the value 'median'.

[Feature] Support axis filter in specific cases. #12832.

[Fix] Fix bmap first layout may be incorrect if container's layout is flex or grid. #13432.

[Fix] Hide tooltip when mouse leaves the chart #13382.

[Fix] Fix bmap personalization style does not work. #13214.

[Fix] Fix the bug of overriding title when click the stack button. #13372.

[Fix] Fix ECharts keeps rendering white blanks with large datasets on single canvas mode #13283.

[Fix] Make contentToOption totally optional. #13139.

[Fix] Keep axis tooltip open on refresh. #13100.

[Fix] Skip rendering for data out of axis content in heatmap. #12991.

[Break] Breaking changes against v4.9:

The default theme colors has been changed. If intending to use the theme of 4.9-, please set option.color = ['#c23531', '#2f4554', '#61a0a8', '#d48265', '#91c7ae', '#749f83', '#ca8622', '#bda29a', '#6e7074', '#546570', '#c4ccd3'];.

Remove built-in map geoJSON. #13565.

The exported modules from 'echarts/lib/export.js' is not mounted to 'echarts/lib/echarts.js' by default. If the upper application previously used import echarts from 'echarts/lib/echarts' and used any of the exported modules in 'echarts/lib/export.js', please change the import code to import echarts from 'echarts/index.blank', where the modules from 'echarts/lib/export.js' are mounted by default.

If the upper application previously imported src/echarts.js, src/chart/*.js and src/component/*.js, it can not work any more because all of the files in /src folder are migrated to *.ts. Instead, the upper application can import esm/echarts.js, esm/chart/*.js and esm/component/*.js.

Drop the support of the legacy IE8. The previous VML renderer (necessary in IE8) will not be updated to work in v5.0 util someone proposed with their real scenario.

The priority of the visuals between visualMap and itemStyle|lineStyle|areaStyle are reversed. That is, previously, the visuals (i.e., color, symbol, symbolSize, ...) that generated by the component visualMap has highest priority, which will overwrite the same visuals specified in itemStyle|lineStyle|areaStyle. That brought trouble to specify specific style to some certain data items. Since v5.0, the visuals specified in itemStyle|lineStyle|areaStyle has highest priority.

The behavior of rich.?.padding are changed. Previously rich.?.padding: [11, 22, 33, 44] indicates that the top padding is 33 and the bottom padding is 11, which is a buggy implementation because it is different from what CSS did. Since v5.0, we fix it: rich.?.padding: [11, 22, 33, 44] indicates the top padding is 11 and the bottom padding is 33.

aria is not included in dist/echarts.simple(.min).js since v5.0. But it is still included in dist/echarts.common(.min).js and dist/echarts(.min).js.

[Deprecated] Deprecated usages since v5.0:

Transform related props of a graphic element are changed:

Changes:

position: [number, number] are changed to x: number/y: number.

scale: [number, number] are changed to scaleX: number/scaleY: number.

origin: [number, number] are changed to originX: number/originY: number.

The position, scale and origin are still supported but deprecated.

It effects these places:

In the graphic components: the declarations of each element.

In custom series: the declarations of each element in the return of renderItem.

Directly use zrender graphic elements.

Text related props on graphic elements are changed:

Changes:

The declaration of attached text (or say, rect text) are changed.

Prop style.text are deprecated in elements except Text. Instead, Prop set textContent and textConfig are provided to support more powerful capabilities.

These related props at the left part below are deprecated. Use the right part below instead.

textPosition => textConfig.position

textOffset => textConfig.offset

textRotation => textConfig.rotation

textDistance => textConfig.distance

The props at the left part below are deprecated in style and style.rich.?. Use the props at the right part below instead.

textFill => fill

textStroke => stroke

textFont => font

textStrokeWidth => lineWidth

textAlign => align

textVerticalAlign => verticalAlign;

textLineHeight =>lineHeight

textWidth => width

textHeight => hight

textBackgroundColor => backgroundColor

textPadding => padding

textBorderColor => borderColor

textBorderWidth => borderWidth

textBorderRadius => borderRadius

textBoxShadowColor => shadowColor

textBoxShadowBlur => shadowBlur

textBoxShadowOffsetX => shadowOffsetX

textBoxShadowOffsetY => shadowOffsetY

Note: these props are not changed:

textShadowColor

textShadowBlur

textShadowOffsetX

textShadowOffsetY

It effects these places:

In the graphic components: the declarations of each element. [compat, but not accurately the same in some complicated cases.]

In custom series: the declarations of each element in the return of renderItem. [compat, but not accurately the same in some complicated cases].

Directly use zrender graphic elements. [No compat, breaking change].

Chart instance

chart.one(...) is deprecated.

label:

In props color, textBorderColor, backgroundColor and borderColor, the value 'auto' is deprecated. Use the value 'inherit' instead.

hoverAnimation:

option series.hoverAnimation is deprecated. Use series.emphasis.scale instead.

line series:

option series.clipOverflow is deprecated. Use series.clip instead.

custom series:

In renderItem, the api.style(...) and api.styleEmphasis(...) are deprecated. Because it is not really necessary and hard to ensure backward compatibility. Users can fetch system designated visual by api.visual(...).

sunburst series:

Action type highlight is deprecated. Use sunburstHighlight instead.

Action type downplay is deprecated. Use sunburstUnhighlight instead.

option series.downplay is deprecated. Use series.blur instead.

option series.highlightPolicy is deprecated. Use series.emphasis.focus instead.

pie series:

The action type at the left part below are deprecated. Use the right part instead:

pieToggleSelect => toggleSelect

pieSelect => select

pieUnSelect => unselect

The event type at the left part below are deprecated. Use the right part instead:

pieselectchanged => selectchanged

pieselected => selected

pieunselected => unselected

option series.label.margin is deprecated. Use series.label.edgeDistance instead.

option series.clockWise is deprecated. Use series.clockwise instead.

option series.hoverOffset is deprecated. Use series.emphasis.scaleSize instead.

map series:

The action type at the left part below are deprecated. Use the right part instead:

mapToggleSelect => toggleSelect

mapSelect => select

mapUnSelect => unselect

The event type at the left part below are deprecated. Use the right part instead:

mapselectchanged => selectchanged

mapselected => selected

mapunselected => unselected

option series.mapType is deprecated. Use series.map instead.

option series.mapLocation is deprecated.

graph series:

option series.focusNodeAdjacency is deprecated. Use series.emphasis: { focus: 'adjacency'} instead.

gauge series:

option series.clockWise is deprecated. Use series.clockwise instead.

option series.hoverOffset is deprecated. Use series.emphasis.scaleSize instead.

dataZoom component:

option dataZoom.handleIcon need prefix path:// if using SVGPath.

radar:

option radar.name is deprecated. Use radar.axisName instead.

option radar.nameGap is deprecated. Use radar.axisNameGap instead.

Parse and format:

echarts.format.formatTime is deprecated. Use echarts.time.format instead.

echarts.number.parseDate is deprecated. Use echarts.time.parse instead.

echarts.format.getTextRect is deprecated.

Source code(tar.gz)
Source code(zip)
5.0.0-rc.3(Nov 20, 2020)

Source code(tar.gz)
Source code(zip)

Apache ECharts is a powerful, interactive charting and data visualization library for browser

Related tags

Overview

Apache ECharts

Get Apache ECharts

Docs

Get Help

Build

Contribution

Resources

Awesome ECharts

Extensions

License

Code of Conduct

Paper

Comments

One-line summary [问题简述]

Version & Environment [版本及环境]

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

Other comments [其他信息]

What problem does this feature solve?

What does the proposed API look like?

问题简述 (One-line summary)

版本及环境 (Version & Environment)

重现步骤 (Steps to reproduce)

期望结果 (Expected behaviour)

可能哪里有问题 (What went wrong)

ECharts配置项 (ECharts option)

其他信息 (Other comments)

One-line summary [问题简述]

Version & Environment [版本及环境]

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

Other comments [其他信息]

One-line summary [问题简述]

Version & Environment [版本及环境]

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

Other comments [其他信息]

Version

Steps to reproduce

What is expected?

What is actually happening?

One-line summary [问题简述]

Version & Environment [版本及环境]

Expected behaviour [期望结果]

ECharts option [ECharts配置项]

Other comments [其他信息]

Version

Steps to reproduce

What is expected?

What is actually happening?

Version

Link to Minimal Reproduction

Steps to Reproduce

Current Behavior

Expected Behavior

Environment

Any additional comments?

What problem does this feature solve?

What does the proposed API look like?

Version

Link to Minimal Reproduction

Steps to Reproduce

Current Behavior

Expected Behavior

Environment

Any additional comments?

What problem does this feature solve?

What does the proposed API look like?

What problem does this feature solve?

What does the proposed API look like?

What problem does this feature solve?

What does the proposed API look like?

Releases(5.4.1)

5.4.1(Dec 9, 2022)

5.4.1-rc.1(Dec 1, 2022)

5.4.0(Sep 25, 2022)

5.4.0-rc.1(Sep 13, 2022)