This is an automated email from the ASF dual-hosted git repository. wangzx pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/incubator-echarts-doc.git
The following commit(s) were added to refs/heads/master by this push: new 90e2608 chore(changelog): fix some typos, format issues and example links in zh changelog. 90e2608 is described below commit 90e2608fc7127b8cc2b167cfafa4bef6e7a03680 Author: plainheart <y...@all-my-life.cn> AuthorDate: Thu Dec 31 10:41:39 2020 +0800 chore(changelog): fix some typos, format issues and example links in zh changelog. --- zh/changelog.md | 54 +++++++++++++++++++++++++++--------------------------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/zh/changelog.md b/zh/changelog.md index 547210c..c8cdaf5 100644 --- a/zh/changelog.md +++ b/zh/changelog.md @@ -8,8 +8,8 @@ + [Feature] 状态增强: + 支持了状态切换时的过渡动画。这能提供更好的视觉效果,尤其比如当常见的部分图形元素因为被“高亮/淡出”时。 + 对于所有系列,新增了状态 `select` 和 `blur`。它们的配置,同我们已有的 `emphasis` 状态一样。`blur` 状态一般可以用于这样的场景:当部分图形元素被关注时,其他图形元素的淡出样式设置。`select` 状态一般可用于鼠标、触摸或 API 选中图形元素而导致样式改变的场景。 - + 全系列支持了淡出效果,当某一部分图形元素被聚焦时(通过鼠标、触摸或 API),其他图形元素淡出,以突出被关注的图形元素。可看这些例子: [bar-label-rotation](https://echarts.apache.org/next/examples/en/editor.html?c=bar-label-rotation)、[bar-polar-stack](https://echarts.apache.org/next/examples/en/editor.html?c=bar-polar-stack)、[bar-stack](https://echarts.apache.org/next/examples/en/editor.html?c=bar-stack)、[area-stack](https://echarts.apache.org/next/examples/en/editor.html?c=area-stack)、[dataset-link](https://echarts.apache.org/next/examples/en/edi [...] - + 原先在不同系列中,形式不一样但是功能类似的配置项:`highlightPolicy`、`focusNodeAdjacency`、`hoverOffset`,被统一为:`focus`、`blurScope` 和 `scale`。参见示例 [sankey-energy](https://echarts.apache.org/next/examples/en/editor.html?c=sankey-energy)、[graph](https://echarts.apache.org/next/examples/en/editor.html?c=graph)、[sunburst-drink](https://echarts.apache.org/next/examples/en/editor.html?c=sunburst-drink)。 + + 全系列支持了淡出效果,当某一部分图形元素被聚焦时(通过鼠标、触摸或 API),其他图形元素淡出,以突出被关注的图形元素。可看这些例子: [bar-label-rotation](https://echarts.apache.org/next/examples/zh/editor.html?c=bar-label-rotation)、[bar-polar-stack](https://echarts.apache.org/next/examples/zh/editor.html?c=bar-polar-stack)、[bar-stack](https://echarts.apache.org/next/examples/zh/editor.html?c=bar-stack)、[area-stack](https://echarts.apache.org/next/examples/zh/editor.html?c=area-stack)、[dataset-link](https://echarts.apache.org/next/examples/zh/edi [...] + + 原先在不同系列中,形式不一样但是功能类似的配置项:`highlightPolicy`、`focusNodeAdjacency`、`hoverOffset`,被统一为:`focus`、`blurScope` 和 `scale`。参见示例 [sankey-energy](https://echarts.apache.org/next/examples/zh/editor.html?c=sankey-energy)、[graph](https://echarts.apache.org/next/examples/zh/editor.html?c=graph)、[sunburst-drink](https://echarts.apache.org/next/examples/zh/editor.html?c=sunburst-drink)。 + 更多细节可见 [#12925](https://github.com/apache/incubator-echarts/pull/12925) 和 [#12911](https://github.com/apache/incubator-echarts/pull/12911)。 + [Feature] 标签增强: + 采用一些策略优化了标签显示效果: @@ -17,33 +17,33 @@ + 在饼图(pie chart)上,优化了标签的排布算法,尤其针对标签非常多的时候,避免重叠。详情见 [#6050](https://github.com/apache/incubator-echarts/issues/6050)。 + 针对文本超出(overflow)区域的场景,提供了多种配置策略。 + 提供一组配置项 `labelLayout`,能够在标签由图表初始定位后,调整其布局。通过 `labelLayout` 中的选项,开发者可以: - + 避免标签重叠(参见[scatter-label-align-right](https://echarts.apache.org/next/examples/en/editor.html?c=graph-label-overlap))。 - + 实现特殊的标签对齐方式,以及调整标签位置等。参见示例 [pie-alignTo](https://echarts.apache.org/next/examples/en/editor.html?c=pie-alignTo)、[pie-label-line-adjust](https://echarts.apache.org/next/examples/en/editor.html?c=pie-labelLine-adjust)、[pie-label-distanceToLabelLine](https://echarts.apache.org/next/examples/en/editor.html?c=doc-example/pie-label-distanceToLabelLine)、[pie-label-bleedMargin](https://echarts.apache.org/next/examples/en/editor.html?c=doc-example/pie-label-bleedMargin)。 + + 避免标签重叠(参见 [scatter-label-align-right](https://echarts.apache.org/next/examples/zh/editor.html?c=graph-label-overlap))。 + + 实现特殊的标签对齐方式,以及调整标签位置等。参见示例 [pie-alignTo](https://echarts.apache.org/next/examples/zh/editor.html?c=pie-alignTo)、[pie-label-line-adjust](https://echarts.apache.org/next/examples/zh/editor.html?c=pie-labelLine-adjust)、[pie-label-distanceToLabelLine](https://echarts.apache.org/next/examples/zh/editor.html?c=doc-example/pie-label-distanceToLabelLine)、[pie-label-bleedMargin](https://echarts.apache.org/next/examples/zh/editor.html?c=doc-example/pie-label-bleedMargin)。 + 支持标签拖动。 - + 在所有系列中都支持 `labelLine` 配置。当标签不得不离图形元素比较远时,`labelLine` 能够视觉关联图形元素和其标签。参见示例 [scatter-label-align-right](https://echarts.apache.org/next/examples/en/editor.html?c=scatter-label-align-right)、[scatter-label-align-top](https://echarts.apache.org/next/examples/en/editor.html?c=scatter-label-align-top)。更多详情请见 [#11534](https://github.com/apache/incubator-echarts/issues/11534)、[#12971](https://github.com/apache/incubator-echarts/issues/12971)。 + + 在所有系列中都支持 `labelLine` 配置。当标签不得不离图形元素比较远时,`labelLine` 能够视觉关联图形元素和其标签。参见示例 [scatter-label-align-right](https://echarts.apache.org/next/examples/zh/editor.html?c=scatter-label-align-right)、[scatter-label-align-top](https://echarts.apache.org/next/examples/zh/editor.html?c=scatter-label-align-top)。更多详情请见 [#11534](https://github.com/apache/incubator-echarts/issues/11534)、[#12971](https://github.com/apache/incubator-echarts/issues/12971)。 + 在折线图中支持 `series.endLabel`。这样标签可以显示在折线的一端。比较清晰得指示这条折线的含义。 + 支持标签文本动画,也就是,标签文本数字变化时的过渡动画。通过 `series.label.valueAnimation`, `series.endLabel.valueAnimation` 可以开关它。其他细节参见 [#13246](https://github.com/apache/incubator-echarts/pull/13246) 和 [#13045](https://github.com/apache/incubator-echarts/pull/13045)。 + 更多详情请参见 [#12911](https://github.com/apache/incubator-echarts/pull/12911)。 -+ [Feature] 支持柱状图的动态排序。其开关是 `series.realtimeSort`。参见示例 [bar-race](https://echarts.apache.org/next/examples/en/editor.html?c=bar-race),以及原始的 PR [#12484](https://github.com/apache/incubator-echarts/pull/12484)。 ++ [Feature] 支持柱状图的动态排序。其开关是 `series.realtimeSort`。参见示例 [bar-race](https://echarts.apache.org/next/examples/zh/editor.html?c=bar-race),以及原始的 PR [#12484](https://github.com/apache/incubator-echarts/pull/12484)。 + [Feature] 支持数据转换插件。 + 数据转换是一套新的配置和API,以声明的方式,实现基于 `dataset` 的数据转换。内置或第三方的数据变换器可以作为插件来提供各种转换算法。开发者可以在 `option` 中配置这些转换器。 - + 参见示例 [data-transform-filter](https://echarts.apache.org/next/examples/en/editor.html?c=data-transform-filter)、[data-transform-sort-bar](https://echarts.apache.org/next/examples/en/editor.html?c=data-transform-sort-bar)、[data-transform-multiple-pie](https://echarts.apache.org/next/examples/en/editor.html?c=data-transform-multiple-pie)、[doc-example/data-transform-multiple-sort-bar](https://echarts.apache.org/next/examples/en/editor.html?c=doc-example/data-transform-multiple-sort-bar) [...] + + 参见示例 [data-transform-filter](https://echarts.apache.org/next/examples/zh/editor.html?c=data-transform-filter)、[data-transform-sort-bar](https://echarts.apache.org/next/examples/zh/editor.html?c=data-transform-sort-bar)、[data-transform-multiple-pie](https://echarts.apache.org/next/examples/zh/editor.html?c=data-transform-multiple-pie)、[doc-example/data-transform-multiple-sort-bar](https://echarts.apache.org/next/examples/zh/editor.html?c=doc-example/data-transform-multiple-sort-bar) [...] + [Feature] 时间轴标签和刻度排列优化。 + 查看更多细节在 [#12859](https://github.com/apache/incubator-echarts/pull/12859)。 + [Feature] 支持贴画纹理(decal)。 - + 贴画纹理提供了一种新的视觉类型,它不仅增强了无障碍访问(aria)场景,还提供了颜色以外的视觉编码方式,来区分数据。 + + 贴画纹理提供了一种新的视觉类型,它不仅增强了无障碍访问(aria)场景,还提供了颜色以外的视觉编码方式,来区分数据。 + 更多细节见 [#13304](https://github.com/apache/incubator-echarts/pull/13304)。 + [Feature] 支持自定义系列的过渡动画。 - + 通过设置变换相关属性、样式属性和形状属性的 `transition` 属性,可以自动执行过渡动画。参见 [custom-gauge](https://echarts.apache.org/next/examples/en/editor.html?c=custom-gauge)。 - + 通过对元素定义设置属性`morph`,支持变形/合并/分离。参见示例 [custom-combine-separate-morph](https://echarts.apache.org/next/examples/en/editor.html?c=custom-combine-separate-morph)、[custom-one-to-one-morph](https://echarts.apache.org/next/examples/en/editor.html?c=custom-one-to-one-morph)、[custom-story-transition](https://echarts.apache.org/next/examples/en/editor.html?c=custom-story-transition)、[custom-spiral-race](https://echarts.apache.org/next/examples/en/editor.html?c=custom-spiral-race)。 - + 通过回调 `during` 支持自定义过渡动画。参见示例 [custom-spiral-race](https://echarts.apache.org/next/examples/en/editor.html?c=custom-spiral-race),并参见 [#12775](https://github.com/apache/incubator-echarts/pull/12775) 中的更多细节。 + + 通过设置变换相关属性、样式属性和形状属性的 `transition` 属性,可以自动执行过渡动画。参见 [custom-gauge](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-gauge)。 + + 通过对元素定义设置属性`morph`,支持变形/合并/分离。参见示例 [custom-combine-separate-morph](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-combine-separate-morph)、[custom-one-to-one-morph](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-one-to-one-morph)、[custom-story-transition](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-story-transition)、[custom-spiral-race](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-spiral-race)。 + + 通过回调 `during` 支持自定义过渡动画。参见示例 [custom-spiral-race](https://echarts.apache.org/next/examples/zh/editor.html?c=custom-spiral-race),并参见 [#12775](https://github.com/apache/incubator-echarts/pull/12775) 中的更多细节。 + 详见 [#12775](https://github.com/apache/incubator-echarts/pull/12775)、[#13468](https://github.com/apache/incubator-echarts/pull/13468)、[#13271](https://github.com/apache/incubator-echarts/pull/13271)。 + [Feature] 提供了更强大的仪表。 - + 请参见示例 [gauge-barometer](https://echarts.apache.org/next/examples/en/editor.html?c=gauge-barometer)、[gauge-clock](https://echarts.apache.org/next/examples/en/editor.html?c=gauge-clock)、[gauge-multi-title](https://echarts.apache.org/next/examples/en/editor.html?c=gauge-multi-title)、[gauge-progress](https://echarts.apache.org/next/examples/en/editor.html?c=gauge-progress)、[gauge-ring](https://echarts.apache.org/next/examples/en/editor.html?c=gauge-ring)、[gauge-grade](https://echarts.a [...] + + 请参见示例 [gauge-barometer](https://echarts.apache.org/next/examples/zh/editor.html?c=gauge-barometer)、[gauge-clock](https://echarts.apache.org/next/examples/zh/editor.html?c=gauge-clock)、[gauge-multi-title](https://echarts.apache.org/next/examples/zh/editor.html?c=gauge-multi-title)、[gauge-progress](https://echarts.apache.org/next/examples/zh/editor.html?c=gauge-progress)、[gauge-ring](https://echarts.apache.org/next/examples/zh/editor.html?c=gauge-ring)、[gauge-grade](https://echarts.a [...] + 更多细节见 [#13416](https://github.com/apache/incubator-echarts/pull/13416)。 + [Feature] 改进了默认的主题和交互方式。其中,为样式和交互,提供了一些新的设定选项。 + tooltip 样式增强。参见 [#12947](https://github.com/apache/incubator-echarts/pull/12947)、[#13398](https://github.com/apache/incubator-echarts/pull/13398)、[#13242](https://github.com/apache/incubator-echarts/pull/13242)。 - + 提供可配置的仪表盘样式。参见 [#12961](https://github.com/apache/incubator-echarts/pull/12961)。 + + 为线和边框提供可配置的虚线样式。参见 [#12961](https://github.com/apache/incubator-echarts/pull/12961)。 + 指针的样式增强。参见 [#13046](https://github.com/apache/incubator-echarts/pull/13046)。 + DataZoom 同时支持刷选和拖拽。参见 [#13025](https://github.com/apache/incubator-echarts/pull/13025)。 + 支持了 `darkMode`。参见 [12911](https://github.com/apache/incubator-echarts/pull/12911)。 @@ -55,12 +55,12 @@ + 构建方式改进。参见 [#13038](https://github.com/apache/incubator-echarts/pull/13038)。 + Japanese:[#13470](https://github.com/apache/incubator-echarts/pull/13470)。 + German:[#13315](https://github.com/apache/incubator-echarts/pull/13315)。 - + French:[#13056](): [#13056](https://github.com/apache/incubator-echarts/pull/13056)。 + + French:[#13056](https://github.com/apache/incubator-echarts/pull/13056)。 + FI/ES/TH:[#13055](https://github.com/apache/incubator-echarts/pull/13055)。 + [Feature] 在饼图和旭日图上,支持圆角。 + 参见 [#13390](https://github.com/apache/incubator-echarts/pull/13390) 和 [#13378](https://github.com/apache/incubator-echarts/pull/13378)。 + [Feature] 增强 tooltip 的配置能力。 - + 支持为 tooltip 添加 CSS 类。参见 [#13383](https://github.com/apache/incubator-echarts/pull/13383).支持在tooltip中添加CSS类。 + + 支持为 tooltip 添加 CSS 类。参见 [#13383](https://github.com/apache/incubator-echarts/pull/13383)。 + 支持在 tooltip formatter 中返回 DOM。参见 [#13469](https://github.com/apache/incubator-echarts/pull/13469)。 + [Feature] 支持部分删除组件或替换组件( replaceMerge )。 + 详情见 [#12987](https://github.com/apache/incubator-echarts/pull/12987)。 @@ -72,7 +72,7 @@ + 其他:[#13339](https://github.com/apache/incubator-echarts/pull/13339)。 + 其他功能、改进和问题修复。 + [Feature] 改进了 `parseDate`。参见 [#13044](https://github.com/apache/incubator-echarts/pull/13044)。 - + [Feature] 当线处于 emphasis 状态时,加租。参见 [#13013](https://github.com/apache/incubator-echarts/pull/13013)。 + + [Feature] 当线处于 `emphasis` 状态时,加粗。参见 [#13013](https://github.com/apache/incubator-echarts/pull/13013)。 + [Feature] 桑吉图 (`sankey`)支持了 `lineStyle: {color: 'gradient'}`。 + [Feature] `markPoint.data.type` 和 `markArea.data.type` 支持了值 `'median'`。 + [Feature] 在一些特定情况下,坐标轴支持了过滤数据。参见 [#12832](https://github.com/apache/incubator-echarts/pull/12832)。 @@ -92,14 +92,14 @@ + `'echarts/lib/export.js'` 中声明的模块,不再默认挂载到 `'echarts/lib/echarts.js'` 中。如果上层应用之前使用了 `import * as echarts from 'echarts/lib/echarts'` 并使用了 `'echarts/lib/export.js'` 中的任何一个模块,请将代码改为 `import echarts from 'echarts/index.blank'`,在这里,`'echarts/lib/export.js'` 中的模块,才被默认挂载。 + 如果上层应用之前引用了 `src/echarts.js`、`src/chart/*.js`、`src/component/*.js`,则不再能这么引用了。因为 `/src` 文件夹中的所有文件都被迁移为 `*.ts`。 + 颠倒了 `visualMap` 和 `itemStyle`|`lineStyle`|`areaStyle` 的优先级。也就是说,以前,由`visualMap` 组件生成的视觉效果(即颜色、符号、符号大小等)具有最高优先级,将覆盖 `itemStyle`|`lineStyle`|`areaStyle` 中指定的相同视觉效果。这种设定带来了一些麻烦,比如给一些特定的数据项指定特定的样式时。从 v5.0 开始,`itemStyle`|`lineStyle`|`areaStyle` 中指定的视觉效果具有了最高优先级。 - + 改变了 `rich.?.padding` 的行为。以前的 `rich.?.padding: [11, 22, 33, 44]` 表示 padding-top 是 `33`,padding-bottom 是 `11`,这是一个有问题的实现,因为它与 CSS 的做法不同。从 v5.0 开始,我们对它进行了修复。`rich.?.padding: [11, 22, 33, 44]` 表示 padding-top `11`,padding-bottom 是`33`。 + + 改变了 `rich.?.padding` 的行为。以前的 `rich.?.padding: [11, 22, 33, 44]` 表示 padding-top 是 `33`,padding-bottom 是 `11`,这是一个有问题的实现,因为它与 CSS 的做法不同。从 v5.0 开始,我们对它进行了修复。`rich.?.padding: [11, 22, 33, 44]` 表示 padding-top 是 `11`,padding-bottom 是 `33`。 + `aria` 从 v5.0 开始不再包含在 `dist/echarts.simple(.min).js` 中。但它仍然包含在 `dist/echarts.common(.min).js` 和 `dist/echarts(.min).js` 中。 + [Deprecated] 从 v5.0 开始已不推荐使用做法: + 图形元素 transform 相关的属性被改变了: + 变更点: - + `position: [number, number]` 改为 `x: number`/`y: number`。 - + `scale: [number, number]` 改为 `scaleX: number`/`scaleY: number`。 - + `origin: [number, number]` 改为 `originX: number`/`originY: number`。 + + `position: [number, number]` 改为 `x: number` / `y: number`。 + + `scale: [number, number]` 改为 `scaleX: number` / `scaleY: number`。 + + `origin: [number, number]` 改为 `originX: number` / `originY: number`。 + `position`、`scale` 和 `origin` 仍然支持,但已不推荐使用。 + 它影响到这些地方: + 在`graphic`组件中:每个元素的声明。 @@ -147,16 +147,16 @@ + `label`。 + 属性 `color`、`textBorderColor`、`backgroundColor`、`borderColor` 中,值 `auto` 已不推荐使用,而推荐使用 `'inherit'` 代替。 + `hoverAnimation`: - + 选项 `series.hoverAnimation` 已不推荐使用,使用 `series.phasis.scale` 代替之。 + + 选项 `series.hoverAnimation` 已不推荐使用,使用 `series.emphasis.scale` 代替之。 + 折线图(`line series`): + 选项 `series.clipOverflow` 已不推荐使用,使用 `series.clip` 代替之。 + 自定义系列(`custom series`)。 + 在 `renderItem` 中,`api.style(...)` 和 `api.styleEmphasis(...)` 已不推荐使用。因为这两个接口其实并不真正必要,也很难保证向后兼容。用户可以通过 `api.visual(...)` 获取系统自动分配的视觉信息。 + 旭日图(`sunburst`): - +动作类型`highlight`已被废弃,使用`sunburstHigh`。使用`sunburstHighlight`代替。 - + 动作类型 "downplay "已被弃用,请使用 "sunburstUniversity "代替。使用`sunburstUnhighlight`代替。 - +选项`series.downplay`已被弃用,请使用`series.blush`代替。使用`series.blur`代替。 - +选项`series.highlightPolicy`已不适用。使用`series.emphasis.focus`代替。 + + 动作类型 `highlight` 已被弃用,请使用 `sunburstHighlight` 代替。 + + 动作类型 `downplay` 已被弃用,请使用 `sunburstUnhighlight` 代替。 + + 选项 `series.downplay` 已被弃用,请使用 `series.blur` 代替。 + + 选项 `series.highlightPolicy` 已不适用,请使用 `series.emphasis.focus` 代替。 + 饼图(`pie`): + 下面左边部分的 action 名已经不推荐使用。请使用右边的 action 名。 + `pieToggleSelect` => `toggleSelect`。 @@ -168,7 +168,7 @@ + `pieunselected` => `unselected`。 + 选项 `series.label.margin` 已经不推荐使用。使用 `series.label.edgeDistance` 代替。 + 选项 `series.clockWise` 已经不推荐使用。使用 `series.clockwise` 代替。 - + 选项 `series.hoverOffset` 已经不推荐使用。使用 `series.phasis.scaleSize` 代替。 + + 选项 `series.hoverOffset` 已经不推荐使用。使用 `series.emphasis.scaleSize` 代替。 + 地图(`map series`): + 下文左边部分的 action 名已经不推荐使用。请使用右边的 action 名。 + `mapToggleSelect` => `toggleSelect`。 @@ -184,7 +184,7 @@ + 选项 `series.focusNodeAdjacency` 已经不推荐使用。使用 `series.emphasis: { focus: 'adjacency'}` 代替。 + 仪表盘(`gauge series`): + 选项 `series.clockWise` 已经不推荐使用。使用 `series.clockwise` 代替。 - + 选项 `series.hoverOffset` 已经不推荐使用。使用 `series.phasis.scaleSize` 代替。 + + 选项 `series.hoverOffset` 已经不推荐使用。使用 `series.emphasis.scaleSize` 代替。 + `dataZoom` 组件: + 选项 `dataZoom.handleIcon` 如果使用 `SVGPath`,需要前缀 `path://`。 + 雷达图(`radar`): --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@echarts.apache.org For additional commands, e-mail: commits-h...@echarts.apache.org