5.0.7

What's Changed

Bug Fixes

• animation: update non-transform attribute and replace node without animation (#5019) (4adbd58), closes #4953 #5006
• axis: autoHide should not set crossSize (#5032) (86052fc)
• change data wont update (#5002) (349a9f4)
• fix issue that legend category cannot update shape (#4968) (152bc18)
• legend-filter: funnel (#4960) (be67dfa)
• link: right env var (#5027) (6481b00)
• point: opacityAttribute default to colorAttribute (#4981) (79399d0)
• scale: zero domain min and max (#5014) (2e92914)
• svg renderer not works in website demo (#5000) (b94ef47)
• tooltip: rerender correctly (#4962) (f85e72f)

Features

• add thresholds params in gauge mark (#5021) (66a4a8e)
• brush: support resize and custom (#5012) (857fa7b)
• event: emit plot events (#5034) (67576ac)
• tooltip render to mount dom (#5025) (d6e098f)
• tooltip: on and emit (#4980) (5f64f71)
• update gui and adapt to crossSize config (#4949) (d1d9b8d)

Full Changelog: 5.0.6...5.0.7

5.0.6

What's Changed

• fix: chart.options changeData problem by @pepper-nice in #4936
• fix: chart.theme as unrequired params by @pepper-nice in #4940
• fix(test): unhandled promise rejection by @pearmini in #4943
• feat: chart bind autoFit in render by @pepper-nice in #4941
• docs: how to custom renderer in umd bundle by @xiaoiver in #4948
• feat(interaction): support focus context by @pearmini in #4946
• chore: bump to 5.0.6 by @pearmini in #4958

Full Changelog: 5.0.5...5.0.6

5.0.5

What's Changed

• fix(axis): order of ticks for transposed x axis by @pearmini in #4918
• fix(interaction): transpose sliderFilter by @pearmini in #4919
• chore(ci): remove gpt-cr by @pearmini in #4924
• fix(chart): autoFit do not set width and height of chart options by @pearmini in #4922
• fix(chart): new Chart() do not set default view key by @pearmini in #4925
• docs(site): add spec tab for examples by @pearmini in #4929
• fix(transform): sort x only sort data in specified domain by @pearmini in #4932
• feat(interaction): brushFilter emit filter event by @pearmini in #4933
• chore: bump to 5.0.5 by @pearmini in #4934

Full Changelog: 5.0.4...5.0.5

5.0.4

What's Changed

• docs: add legend layout docs by @Aarebecca in #4884
• docs: fix simple typo, transfrom -> transform by @timgates42 in #4890
• fix(OOM): clear interaction and cancel animation when rerendering by @pearmini in #4899
• feat(scale): tickCount of log scale support -1 by @pearmini in #4901
• feat: add arrow for lineX, lineY by @hustcc in #4905
• fix: update legend component inferring strategies by @Aarebecca in #4906
• fix(tooltip): show falsy item by default by @pearmini in #4907
• fix(tooltip): missing data by @pearmini in #4910
• chore: add gpt for code review by @hustcc in #4828
• fix: unify params of labelFilter and labelFormatter by @Aarebecca in #4911
• fix(label): support specified transform (close: #4881) by @pearmini in #4914
• fix(demo): disable series tooltip for regression by @pearmini in #4912
• chore(version): update to 5.0.4 by @pearmini in #4916

Full Changelog: 5.0.3...5.0.4

5.0.3

What's Changed

• Update overview.zh.md by @ChenKun1997 in #4874
• docs(site): fix spec timingKeyframe url by @shield2018 in #4872
• fix: 文档中的sort->sortBy by @xujingli in #4876
• docs: correct typo docs by @Aarebecca in #4880
• fix(interval): fix interval render funnel (#4868) by @shield2018 in #4875

New Contributors

• @shield2018 made their first contribution in #4872
• @xujingli made their first contribution in #4876

Full Changelog: 5.0.2...5.0.3

5.0.2

What's Changed

• fix(animation): shape to shape animation take style.transform into ac… by @pearmini in #4849
• fix(axis): unexpected radius in polar by @pearmini in #4850
• fix(types): axis for composition by @pearmini in #4851
• Update size.zh.md by @ChenKun1997 in #4856
• fix(ci): lock version of canvas to 2.11.0 by @pearmini in #4857
• fix(fisheye): reset when pointerleave by @pearmini in #4858
• fix(runtime): wait for the next tick to finish rendering (close: #4771) by @pearmini in #4855
• fix(tooltip): hide tooltip when move mask by @pearmini in #4860
• fix: chart render type (#4853) by @pepper-nice in #4861
• Update coordinate.zh.md by @ChenKun1997 in #4864
• Update annotation.zh.md by @ChenKun1997 in #4865
• Update component.zh.md by @ChenKun1997 in #4866
• fix: update legend marker by @Aarebecca in #4869
• chore: update version to 5.0.2 by @Aarebecca in #4871

New Contributors

• @ChenKun1997 made their first contribution in #4856

Full Changelog: 5.0.1...5.0.2

5.0.1

What's Changed

• docs: remove empty api fold by @pearmini in #4823
• docs: fix docs typo by @Aarebecca in #4825
• docs: update the book name of gg by @neoddish in #4826
• chore: make commitlint work by @hustcc in #4830
• docs(site): update content and styles by @pearmini in #4831
• fix(tooltip): sample by @pearmini in #4832
• fix(tooltip): support NaN data in transpose by @pearmini in #4833
• fix(tests): remove .only by @pearmini in #4835
• feat(ci): throw error for .only and missing snapshot by @pearmini in #4836

New Contributors

• @neoddish made their first contribution in #4826

Full Changelog: 5.0.0...5.0.1

5.0.0

5.0.0 Spring

G2（发音为 /ʤiː tuː/） 是蚂蚁集团 AntV 旗下的开源可视化图表库。今天，我们很激动地宣布 G2 5.0 正式版本 “Spring” 的发布。本次主版本更新包含更简洁和专业的可视化语法，更丰富的图表类型和图表特性，易于拓展的全新 API 和架构。在提高 G2 灵活性和易用性的同时，也为 G2 未来的长期稳定迭代和生态的建设奠定了夯实的基础。

5.0 的发布意味着团队和社区两年多的努力，从最初底层模块 @antv/scale 和 @antv/coord 的梳理开始，而后掘金小册《可视化入门：从 0 到 1 开发一个图表库》的推广，到如今正式版本的发布，这算是一次“蓄谋已久”的升级。5.0 在一年前的今天绘制出了第一个条形图，经过团队和社区成员反复讨论、设计、实现以及不懈的努力，渐渐有了如今的模样。

G2 为公司业务而生，却也希望服务好社区用户，如今一年之期已到，在这春分之时，希望能给大家展现一份满意的答卷。

渐进式可视化语法

G2 从最开始就有一个简单的愿景：“一句话绘制出一个图表”。为此我们实践了图形语法《The Grammar of Graphics》的核心理论：拒绝图表分类学，用一系列可视化组件来描述一个图表。相对于“一图一做”，大大丰富了可绘制图表的种类。但随着可视化场景越来越复杂，以及根据内外用户的反馈，我们发现 G2 在易用性和灵活性上还有不小的提升空间。

为此，我们参考前端框架 React 和 Vue 复用逻辑的编程范式，给出了“Mark 是一等公民”的设计原则，提出了一套“渐进式的可视化语法”：一个可以逐步学习和采用的可视化语法，在保证复杂度几乎不变的情况下，可以为越来越丰富和苛刻的可视化场景提供持续的支持。

同时在可视化描述层面，我们参考了学术界的 Vega-Lite 可视化语法的设计，提高了 G2 语法的通用性和专业性，希望能给用户专递正确的、专业的可视化思维，提高开发效率和更多得从可视化中获益。

更丰富的图表类型

为了满足不同场景的诉求，5.0 新增了更多图表类型：平行坐标系、马赛克图和差分面积图等，同时也将直接支持仪表盘、水波图和韦恩图等的绘制。除此之外，因为图形语法本身的“包罗万象”，以及复合型数据类型场景的增多，G2 将不仅仅针对统计数据，也会为关系型数据和地理数据可视化提供简单的支持（更加专业和复杂的诉求移步 G6 和 L7）。

全新的数据分析能力

大规模和复杂的数据分析往往由后端的完成，针对小规模和特定的场景，我们参考 D3 作者 Mike Bostock 最新开源的 Observable Plot，设计了 transform API 来规范化数据分析的能力。使得用户可以通过简洁的 API 完成分组、分箱、求异常值等分析任务。另一方面，我们也参考 Vega-Lite 的视图复合设计、微软团队的 Atom 单元可视化语法，以及前端开发的 DOM 树规范，设计了一颗视图树去描述可视化。这样不仅可以更容易地去分析高维数据，还可以从“一句话绘制出一个图表”升级为“一句话绘制一张报表”，将不同数据集放在同一页面去分析。

全新的动画能力

可视化中动画可以提高用户的愉悦度，以及更好的展现和分析时序数据。4.0 和大多数主流的可视化框架都没有提供声明形式的动画语法，为了弥补这个缺陷，我们参考山东大学 Canis 动画语法给 5.0 增加了编码动画属性和执行分组动画的能力。同时我们参考 CSS Animation 规范，设计了时序容器，简化了声明可视化叙事的成本。

数据标注能力提升

数据标注常常用于为用户提供值得关注的辅助信息。在 4.0 的设计中，标注 Annotation 和几何元素 Geometry 是两个不同的实现，这使得标注的能力没有几何元素灵活和强大。在 5.0 中，标注和几何元素都是标记 Mark，拥有相同的渲染流程，从而使得标注也获得了声明式的批量绘制、支持数据转换、支持动画以及展现提示信息的能力。同时对于每一个图形元素，也可以添加多个数据标签 Label。

组件展示能力提升

坐标轴和图例等组件可以帮助用户加速理解可视化，在 5.0 中我们优化了组件的展示。包括支持多个坐标轴的自适应布局，更多种的图例布局模式，以及各个部分使用 HTML 定制。Ticks 的文本的混乱展示一直是组件的痛点，我们内置了 d3-format 使得格式化工作更加的简单。

颜色表达力提升

颜色通道是可视化中一个重要的通道，它能高效地展示编码的信息。5.0 增强了对连续颜色通道的展示能力，包括提供 Threshold、Quantile 和 Quantize 比例尺去离散化颜色，让颜色的差异感分布更加明显和均匀。也内置了 d3-scale-chromatic 中的离散色板和连续插值器，提供了更多色彩空间的选择。对于折线图也支持连续的渐变色编码。

丰富个性化风格

为了个性化场景和趣味性需求，借助底层强大的渲染引擎 @antv/g， 所有图表都支持手绘风格和纹理。同时也优化了条形图和饼图等的圆角展示。

实验特性 Spec API

G2 提供了函数风格的链式 API Chart 去声明图表，这样使得图表的声明可以更加自由。但我们发现这种非结构化 API 对部分用户并不友好，同时不利于上层工具的封装。所以在增强传统 Chart API 的同时，G2 5.0 引入了 Spec API 一套全新的 API，旨在降低 G2 的使用和学习成本以及方便生态的扩展。Spec API 是 Chart API 的基础，提供了类似 ECharts 和 G2Plot 那样的通过 JavaScript 对象声明图表的能力。

目前 Spec API 目前在 G2 中已经实现，并可以通过调用 chart.options(options) 使用。但是暴露这个特性的目的只是为了收集反馈，并且给依赖相关能力的库一个预览。我们将和 @antv/ava 团队一起测试和迭代这个功能，并且可能在 5.1 版本中正式发布它。

按需加载

G2 5.0 的核心能力仍然通过 Chart暴露，但是内部实现已经被完全重写，通过 runtime + stdlib 的形式已经解耦成一个个模块的集合。新的架构下为源码提供了更好的可维护性，并且为未来按需打包，减少运行时体积打下了坚实的基础。同时这些模块拥有相似的函数签名，可以在自定义是保持心智的相对统一。

服务端渲染

G2 5.0 拥有了服务端渲染的能力。这也拓展了更多使用场景，例如在一个服务端自动生成内容的邮件或报表系统中嵌入图表。不同于 AnyChart 或者 Highcharts 基于 PhantomJS 这样的无头浏览器方案，我们使用了可以在 Node.js 环境下运行的 node-canvas、JSDOM 和 headless-gl 为不同渲染器提供支持。

基于这个能力，我们去掉了 Jest Electron，并使用 Jest + Vite + Node Canvas 引入了集成测试。其中使用 Vite 的搭建的预览环境，相对于 Jest Electron 提供了更真实的浏览器预览环境，也因为响应快速带来了更好的开发体验。我们可以直接对预览环境中的可视化图表进行截图测试，在提高了测试可靠性和完备性的同时，也大大提高了编写测试的效率：不需要去断言内部可能发生变化的数据结构，为 G2 持续化集成提供了可靠的支持。

分阶段发布

G2 5.0 正式的发布意味着框架已经整体就绪。虽然框架的一些子模块还需要进一步调整和完善才能达到稳定状态（尤其是 Mark 和 Shape 模块的内部接口设计），并且后续还会拆包减少包体积，但是我们相信已经可以使用 G2 5.0 开启全新的项目。同时也鼓励社区使用了 G2 4.0 的库计划升级项目以支持 G2 5.0。

下一阶段工作

对于发布后的一段时间内，我们将重点关注：

• 调整内部接口，暴露各个模块的自定义能力。
• 优化视觉效果，提供更多主题风格以及主题构建工具。
• 落地新的交互规范并且设计新的交互语法。
• 完善 Spec API，提供相应文档、案例以及相关工具。
• 优化性能和保证能力稳定。
• 进一步补全教程和文章。

G2 栈团队还会继续维护 v4 版本，针对 Bug 发布 Patch 版本修复，但是此后不再接收新的 Feature Request，截止日期为 2023 年年底。原 v4 官网迁移至 https://g2-v4.antv.vision/。

如何升级

首先得和社区的广大开发者说一声抱歉，因为这是一个全新的版本，所以对已有项目来说，有不低的升级成本。为了尽可能降低用户的升级成本，我们保证了大部分可视化概念的统一，同时也会提供一个升级文档来指出新老版本的一些差异。在 G2 5.0 版本发布之后，我们也会保持一周一次的版本更新速度，欢迎大家通过 issue、disscusion 和钉钉讨论群抛出在升级过程中遇见的困难，我们将尽全力帮助大家更加平稳的升级。

<img src="https://cdn.nlark.com/yuque/0/2023/png/418707/1678778561077-29820e0c-f977-49fd-9280-7d10c...

5.0.0-rc.2

Please see the 5.0.0-rc.2 release notes for more!

What's Changed

• fix: catch render exceptions and throw them by @wuhaiyang in #4777
• fix(texts): update snapshots by @pearmini in #4780
• fix(animation): keyframe by @pearmini in #4783
• docs: add migration by @pearmini in #4784
• feat: adapt to gui 0.5.0-alpha.5 by @Aarebecca in #4752
• fix(animation): facet keyframe by @pearmini in #4786
• feat(interaction): add sliderFilter to defaults by @pearmini in #4787
• feat(interaction): add legendFilter to defaults by @pearmini in #4788
• fix(tooltip): update after rerendering by @pearmini in #4789
• docs: add tooltip, color, interaction docs by @Aarebecca in #4790
• chore: update version to 5.0.0-rc.2 by @Aarebecca in #4791

Breaking Change

Since the default theme of G2 is still in the preparatory stage, in order to avoid future user changes, we require that the theme should be specified as "classic" when initializing Chart at present. Otherwise you may receive an exception warning and be unable to render the charts.

const chart = new Chart({
  container: 'container',
  theme: 'classic',
  autoFit: true,
});

Full Changelog: v4.2.10...5.0.0-rc.2

v4.2.10

What's Changed

• fix(animate): 部分动画覆盖 callback 配置导致外部的 callback 配置失效 by @zhaokejian in #4678

New Contributors

• @zhaokejian made their first contribution in #4678

Full Changelog: v4.2.9...v4.2.10