All Versions
20
Latest Version
Avg Release Cycle
28 days
Latest Release
389 days ago

Changelog History
Page 1

  • v5.0.0 Changes

    November 10, 2020

    v5.0.0

    • Migrate code base 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:
    • [Feature] Provide more smarter time axis label and tick arrangement:
    • ๐Ÿ‘ [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.
    • [Feature] Provide a more powerful gauge:
    • ๐Ÿ’… [Feature] The default theme and interaction have been greatly enhanced. Some new options are provide 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.
    • ๐Ÿ‘ [Feature] Support rounded conner in pie and sunburst:
    • ๐Ÿ”ง [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:
    • ๐ŸŽ [Enhancement] Enhance performance in some scenarios:
    • Others small bug-fix or enhancement:
      • [Feature] Enhance parseData #13044.
      • #13013
      • [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] remove built-in map geoJSON.
  • v5.0.0-rc.3 Changes

    November 20, 2020

    v5.0.0-rc.3

    • 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:
    • [Feature] Provide more smarter time axis label and tick arrangement:
    • ๐Ÿ‘ [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.
    • [Feature] Provide a more powerful gauge:
    • ๐Ÿ’… [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.
    • ๐Ÿ‘ [Feature] Support rounded corner in pie and sunburst:
    • ๐Ÿ”ง [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:
    • ๐ŸŽ [Enhancement] Enhance performance in some scenarios:
    • ๐Ÿ›  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:
      • Remove built-in map geoJSON. #13565.
      • 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 =>
        • 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.
  • v5.0.0-beta.2

    October 26, 2020
  • v5.0.0-beta.1

    October 14, 2020
  • v5.0.0-alpha.2

    August 17, 2020
  • v5.0.0-alpha.1

    July 31, 2020
  • v4.9.0 Changes

    August 28, 2020

    ๐Ÿ‘ [Feature] [graph] Support multiple edges to link nodes in graph. #12590 (wf123537200)

    ๐Ÿ‘ [Feature] [funnel] Add orient option in funnel. Support horizontal layout. #12754 (regrex)

    [Enhancement] [tooltip] Add text shadow options. #12664 (Ovilia)

    ๐Ÿ’… [Enhancement] [toolbox] Add brushStyle option to configuration style of brush rect in the dataZoom feature. #12550 (zhiyuc123)

    โšก๏ธ [Fix] [themeRiver] Optimize data process in themeRiver. #12022 (Zaynex)

    [Fix] [toolbox] Fix pie series render incorrectly after editing its data in the dataView feature. #12561 (plainheart)

    [Fix] [toolbox] Fix dataView shows NaN when using dataset. #11849 (susiwen8)

    [Fix] [toolbox] Fix saveAsImage may have error in some special environments. #12643 (lzr900515)

    [Fix] [lines] Fix lines disappear if setOption again without data. #12850 (plainheart)

    [Fix] [sunburst] [treemap] Fix label formatter in levels not work bug. #12742 (Ovilia)

    ๐Ÿšš [Fix] [bmap] Fix bmap event moveend is always triggered when dragging or zoomend. #12558 (plainheart)

    [Fix] [grid] Fix wrong gap calculation when containLabelis set in grid. #12259 (Ling310)

    [Fix] [tooltip] Fix newline in tooltip of radar and map series when using ricText render mode. #12664 (Ovilia)

    โšก๏ธ [Fix] [tooltip] Update tooltip position proportionally when chart resized. #12834 (liulinboyi)

    [Fix] [tooltip] Fix tooltip dispose in richText render mode. #12608 (plainheart)

    [Fix] [tree] Fix image symbol not display on first render. #12367 (plainheart)

    [Fix] [geo] Fix label formatter not work bug. #12762 (plainheart)

    [Fix] [bar] Fix error when switching showBackground from false to true. #13085 (easonyq)

    [Fix] [markArea] Fix label is not hidden when markArea is outside the grid. #12669 (Ovilia)

    [Fix] [markLine] [markPoint] Fix symbolRotate not work bug. #12737 #12392 (plainheart)

    [Fix] [polar] Fix bar layout on polar with nagive axis. #12418 (gracelia)

  • v4.9.0-rc.1 Changes

    August 06, 2020

    ๐Ÿ‘ [Feature] [graph] Support multiple edges to link nodes in graph. #12590 (wf123537200)

    ๐Ÿ‘ [Feature] [funnel] Add orient option in funnel. Support horizontal layout. #12754 (regrex)

    [Enhancement] [tooltip] Add text shadow options. #12664 (Ovilia)

    ๐Ÿ’… [Enhancement] [toolbox] Add brushStyle option to configuration style of brush rect in the dataZoom feature. #12550 (zhiyuc123)

    โšก๏ธ [Fix] [themeRiver] Optimize data process in themeRiver. #12022 (Zaynex)

    [Fix] [toolbox] Fix pie series render incorrectly after editing its data in the dataView feature. #12561 (plainheart)

    [Fix] [toolbox] Fix dataView shows NaN when using dataset. #11849 (susiwen8)

    [Fix] [toolbox] Fix saveAsImage may have error in some special environments. #12643 (lzr900515)

    [Fix] [lines] Fix lines disappear if setOption again without data. #12850 (plainheart)

    [Fix] [sunburst] [treemap] Fix label formatter in levels not work bug. #12742 (Ovilia)

    ๐Ÿšš [Fix] [bmap] Fix bmap event moveend is always triggered when dragging or zoomend. #12558 (plainheart)

    [Fix] [grid] Fix wrong gap calculation when containLabelis set in grid. #12259 (Ling310)

    [Fix] [tooltip] Fix newline in tooltip of radar and map series when using ricText render mode. #12664 (Ovilia)

    โšก๏ธ [Fix] [tooltip] Update tooltip position proportionally when chart resized. #12834 (liulinboyi)

    [Fix] [tooltip] Fix tooltip dispose in richText render mode. #12608 (plainheart)

    [Fix] [tree] Fix image symbol not display on first render. #12367 (plainheart)

    [Fix] [geo] Fix label formatter not work bug. #12762 (plainheart)

    [Fix] [bar] Fix error when switching showBackground from false to true. #13085 (easonyq)

    [Fix] [markArea] Fix label is not hidden when markArea is outside the grid. #12669 (Ovilia)

    [Fix] [markLine] [markPoint] Fix symbolRotate not work bug. #12737 #12392 (plainheart)

    [Fix] [polar] Fix bar layout on polar with nagive axis. #12418 (gracelia)

  • v4.8.0 Changes

    May 25, 2020

    ๐Ÿ‘ [Feature] [toolbox] Support download SVG file in toolbox when using SVG render mode. #12144 (Zhang Wenli)

    [Feature] Add more parameters in the loading effect. #12414 (Yu Feng)

    ๐Ÿ‘ [Feature] Support callback for symbolRotate. #12348 #12354 (plainheart)

    0๏ธโƒฃ [Feature] [axis] Callbacks of min, max can return null to use the default value now. #11829 (Su Siwen), #12371 (Su Shuang)

    [Feature] [geo] Add nameProperty to specify the name field of GeoJSON source. #12156 (alex2wong)

    [Fix] [sankey] Fix tooltip not displayed on edges. #12011 (Su Siwen)

    [Fix] [sankey] Fix node may disappear when link value is 0. #12191 (Su Siwen), #12472 (Su Shuang)

    [Fix] [treemap] Add missing params in the foramtter callback. #11854 (Su Siwen, Su Shuang)

    [Fix] [calendar] Fix calendar chart layout when user is in a timezone with DST. #12172 (mikeyshing88), #12466 (Su Shuang)

    [Fix] [line] Fix safari may crash because of memory explosion when using gradient, shadow with large wide-range animation. #12410 (Shen Yi)

    [Fix] [line] Fix clip bug in chromium when chart size over 18000px. #12393 (Zhan Fang)

    [Fix] [pie] Fix label may disappear when animation is disabled. #12243 (Zhang Wenli)

    ๐Ÿ”’ [Fix] [title] Fix potential security risk when '_blank' target for link. #12380 (Su Siwen)

    [Fix] [geo] Fix animation not work when change center or zoom with setOption. #12340 (Zhang Wenli)

    ๐Ÿšš [Fix] [heatmap] Remove the 1px gap. #12342 (SnailSword)

    ๐Ÿ’… [Fix] [sunburst] Fix default downplay style not work bug. #12264 (Shen Yi)

    [Fix] [visualMap] minOpen and maxOpen is not counted into pieces number now. #12147 (Su Siwen)

    [Fix] [bmap] [extension] Fix layer may not been cleared when using progressive rendering. (Shen Yi)

  • v4.8.0-rc.1 Changes

    May 06, 2020

    ๐Ÿš€ Change log: see release 4.8.0