You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@echarts.apache.org by ov...@apache.org on 2020/12/09 06:28:02 UTC
[incubator-echarts-doc] branch next updated: doc: decal for series
in ZH
This is an automated email from the ASF dual-hosted git repository.
ovilia pushed a commit to branch next
in repository https://gitbox.apache.org/repos/asf/incubator-echarts-doc.git
The following commit(s) were added to refs/heads/next by this push:
new 3f7f612 doc: decal for series in ZH
new e9a3821 Merge branch 'next' of github.com:apache/incubator-echarts-doc into next
3f7f612 is described below
commit 3f7f6122ad3efdbadf65b8710b6d52984bd9733b
Author: Ovilia <zw...@gmail.com>
AuthorDate: Wed Dec 9 14:27:29 2020 +0800
doc: decal for series in ZH
---
en/option/component/aria.md | 28 +++++++-------
zh/option/component/aria.md | 76 +++++---------------------------------
zh/option/partial/decal.md | 79 ++++++++++++++++++++++++++++++++++++++++
zh/option/partial/item-style.md | 13 +++++++
zh/option/series/bar.md | 13 +++++++
zh/option/series/boxplot.md | 7 +++-
zh/option/series/custom.md | 6 ++-
zh/option/series/funnel.md | 20 ++++------
zh/option/series/gauge.md | 16 ++++++--
zh/option/series/line.md | 4 +-
zh/option/series/pictorialBar.md | 6 ++-
zh/option/series/pie.md | 6 ++-
zh/option/series/radar.md | 4 +-
zh/option/series/sankey.md | 9 +++--
zh/option/series/sunburst.md | 17 ++++-----
zh/option/series/themeRiver.md | 3 +-
zh/option/series/treemap.md | 9 +++++
17 files changed, 196 insertions(+), 120 deletions(-)
diff --git a/en/option/component/aria.md b/en/option/component/aria.md
index fce7cc8..1b6a91f 100644
--- a/en/option/component/aria.md
+++ b/en/option/component/aria.md
@@ -52,13 +52,13 @@ On the generated chart DOM, there is an `aria-label` attribute that allows the b
> This is a chart of "Source of user access to a site." The chart type is a pie chart that indicates the source of the visit. The data is - direct access data is 335, mail marketing data is 310, union ad data is 234, video ad data is 135, search engine data is 1548.
-The basic process for generating the description is that if [aria.enabled](~aria.enabled) is set to `true` (not the default) and [aria.label.enabled](~aria.label.enabled) is set to `true` (the default), then the accessibility description is generated. Otherwise it is not generated. If [aria.label.description](~aria.description) is defined, it is used as the full description of the chart, otherwise the description is generated according to the template stitching. We provide a default algo [...]
+The basic process for generating the description is that if [aria.enabled](~aria.enabled) is set to `true` (not the default) and [aria.label.enabled](~aria.label.enabled) is set to `true` (the default), then the accessibility description is generated. Otherwise it is not generated. If [aria.label.description](~aria.label.description) is defined, it is used as the full description of the chart, otherwise the description is generated according to the template stitching. We provide a defaul [...]
-When using template stitching, the decision to use [aria.label.general.withTitle](~aria.general.withTitle) or [aria.label.general. withoutTitle](~aria.label.general. withoutTitle) is based on the existence of [title.text](~title.text) or [aria.label.general. withoutTitle](~aria.general. withoutTitle). withoutTitle](~aria.general.withoutTitle) as a global description. The `aria.label.general.withTitle` configuration item includes the template variable `'{title}'`, which will be replaced w [...]
+When using the template, whether [title.text](~title.text) is used along with [aria.label.general.withTitle](option.html#aria.label.general.withTitle) while [aria.label.general.withoutTitle](option.html#aria.label.general.withoutTitle) is used if there is no title text. `aria.general.withTitle` supports a template `'{title}'`, which will be replaced with chart title. This means, if `aria.general.withTitle` is set to be `'The chart title is {title}.'` and the chart title is `Price Distrib [...]
-After piecing the title, the description of the series ([aria.series](~aria.series)), and the description of the data for each series ([aria.data](~aria.data)) are pieced in turn. Again, each template may include template variables to replace the actual values.
+After generating the title, the description of the series ([aria.label.series](option.html#aria.label.series)) and the description of the data for each series ([aria.label.data](option.html#aria.label.data)) are generated in turn. The following is an example of a template. Likewise, each template may include template variables to replace actual values.
-The complete description generation process is.
+The complete description generation process is:
@@ -68,7 +68,7 @@ Whether or not to enable label generation for accessibility. When enabled, the a
### description(string) = null
-By default, an algorithm is used to automatically generate a chart description, but if you want to fully customize it, you can set this value to a description. If it is set to ``This is a chart showing price movements''`, then the value of the `aria-label` attribute is the string.
+By default, an algorithm is used to automatically generate a chart description, but if you want to fully customize it, you can set this value to a description. If it is set to `'This is a chart showing price changes'`, then the value of the `aria-label` attribute of the chart DOM is this string.
This configuration item is often used to display text that specifies a general description of the chart, when displaying individual data does not show the contents of the chart. For example, if the chart is a map with a large number of scattered points, the default algorithm can only show the locations of the data points and cannot convey the author's intent as a whole. In this case, you can specify `description` as what the author wants to say.
@@ -104,41 +104,41 @@ Holistic descriptions for all series are shown before each series description. T
- `{seriesCount}`: will be replaced with the number of series, where it is always 1.
-##### withName(string) = 'The chart type is {seriesType}, which means {seriesName}.'
+##### withName(string) = ' with type {seriesType} named {seriesName}.'
This description is used if the series has the `name` attribute. This includes the template variable.
- `{seriesName}`: will be replaced with `name` of the series.
-- `{seriesType}`: the name of the type that will be replaced with the series, e.g. ``Histogram''`, ``Line Chart''`, etc.''.
+- `{seriesType}`: the name of the type that will be replaced with the series, e.g. `'Bar chart'`, `'Line chart'`, etc.
-##### withoutName(string) = 'The chart type is {seriesType}.'
+##### withoutName(string) = ' with type {seriesType}.'
This description is used if the series has no `name` attribute. This includes the template variable.
-- `{seriesType}`: the name of the type that will be replaced with the series, e.g. ``Histogram''`, ``Line Chart''` and so on.
+- `{seriesType}`: the name of the type that will be replaced with the series, e.g. `'Bar chart'`, `'Line chart'`, etc.
#### multiple(Object)
Description to use when the chart contains only multiple series.
-##### prefix(string) = 'It consists of {seriesCount} of chart series.'
+##### prefix(string) = '. It consists of {seriesCount} series count.'
A holistic description for all series is displayed before each series description. This includes the template variable.
- `{seriesCount}`: will be replaced with the number of series.
-##### withName(string) = 'The chart type is {seriesType}, which means {seriesName}.'
+##### withName(string) = ' The {seriesId} series is a {seriesType} representing {seriesName}.
This description is used if the series has the `name` attribute. This includes the template variable.
- `{seriesName}`: will be replaced with `name` of the series.
-- `{seriesType}`: the name of the type that will be replaced with the series, e.g. ``Histogram''`, ``Line Chart''`, etc.''.
+- `{seriesType}`: the name of the type that will be replaced with the series, e.g. `'Bar chart'`, `'Line chart'`, etc.
-##### withoutName(string) = 'The chart type is {seriesType}.'
+##### withoutName(string) = ' The {seriesId} series is a {seriesType}.'
This description is used if the series has no `name` attribute. This includes the template variable.
-- `{seriesType}`: the name of the type that will be replaced with the name of the series, e.g. ``Histogram'`, ``Line Chart'` and so on.
+- `{seriesType}`: the name of the type that will be replaced with the name of the series, e.g. `'Bar chart'`, `'Line chart'`, etc.
##### separator(Object)
diff --git a/zh/option/component/aria.md b/zh/option/component/aria.md
index efc0ebc..8df79d5 100644
--- a/zh/option/component/aria.md
+++ b/zh/option/component/aria.md
@@ -52,11 +52,11 @@ option = {
> 这是一个关于“某站点用户访问来源”的图表。图表类型是饼图，表示访问来源。其数据是——直接访问的数据是335，邮件营销的数据是310，联盟广告的数据是234，视频广告的数据是135，搜索引擎的数据是1548。
-生成描述的基本流程为，如果 [aria.enabled](~aria.enabled) 设置为 `true`（非默认）且 [aria.label.enabled](~aria.label.enabled) 设置为 `true`（默认），则生成无障碍访问描述，否则不生成。如果定义了 [aria.label.description](~aria.description)，则将其作为图表的完整描述，否则根据模板拼接生成描述。我们提供了默认的生成描述的算法，仅当生成的描述不太合适时，才需要修改这些模板，甚至使用 `aria.label.description` 完全覆盖。
+生成描述的基本流程为，如果 [aria.enabled](~aria.enabled) 设置为 `true`（非默认）且 [aria.label.enabled](~aria.label.enabled) 设置为 `true`（默认），则生成无障碍访问描述，否则不生成。如果定义了 [aria.label.description](~aria.label.description)，则将其作为图表的完整描述，否则根据模板拼接生成描述。我们提供了默认的生成描述的算法，仅当生成的描述不太合适时，才需要修改这些模板，甚至使用 `aria.label.description` 完全覆盖。
-使用模板拼接时，先根据是否存在标题 [title.text](~title.text) 决定使用 [aria.label.general.withTitle](~aria.general.withTitle) 还是 [aria.label.general.withoutTitle](~aria.general.withoutTitle) 作为整体性描述。其中，`aria.label.general.withTitle` 配置项包括模板变量 `'{title}'`，将会被替换成图表标题。也就是说，如果 `aria.label.general.withTitle` 被设置为 `'图表的标题是：{title}。'`，则如果包含标题 `'价格分布图'`，这部分的描述为 `'图表的标题是：价格分布图。'`。
+使用模板拼接时，先根据是否存在标题 [title.text](~title.text) 决定使用 [aria.label.general.withTitle](~aria.label.general.withTitle) 还是 [aria.label.general.withoutTitle](~aria.label.general.withoutTitle) 作为整体性描述。其中，`aria.label.general.withTitle` 配置项包括模板变量 `'{title}'`，将会被替换成图表标题。也就是说，如果 `aria.label.general.withTitle` 被设置为 `'图表的标题是：{title}。'`，则如果包含标题 `'价格分布图'`，这部分的描述为 `'图表的标题是：价格分布图。'`。
-拼接完标题之后，会依次拼接系列的描述（[aria.series](~aria.series)），和每个系列的数据的描述（[aria.data](~aria.data)）。同样，每个模板都有可能包括模板变量，用以替换实际的值。
+拼接完标题之后，会依次拼接系列的描述（[aria.label.series](~aria.label.series)），和每个系列的数据的描述（[aria.label.data](~aria.label.data)）。同样，每个模板都有可能包括模板变量，用以替换实际的值。
完整的描述生成流程为：
@@ -68,7 +68,7 @@ option = {
### description(string) = null
-默认采用算法自动生成图表描述，如果用户需要完全自定义，可以将这个值设为描述。如将其设置为 `'这是一个展示了价格走势的图表'`，则 `aria-label` 属性的值即为该字符串。
+默认采用算法自动生成图表描述，如果用户需要完全自定义，可以将这个值设为描述。如将其设置为 `'这是一个展示了价格走势的图表'`，则图表 DOM 元素的 `aria-label` 属性值即为该字符串。
这一配置项常用于展示单个的数据并不能展示图表内容时，用户显示指定概括性描述图表的文字。例如图表是一个包含大量散点图的地图，默认的算法只能显示数据点的位置，不能从整体上传达作者的意图。这时候，可以将 `description` 指定为作者想表达的内容即可。
@@ -214,6 +214,8 @@ aria: {
~[700x300](${galleryViewPath}doc-example/aria-decal-simple&edit=1&reset=1)
+绝大部分支持填充色的系列都支持贴花图案，包括：`'line'`, `'bar'`, `'pie'`, `'radar'`, `'treemap'`, `'sunburst'`, `'boxplot'`, `'sankey'`, `'funnel'`, `'gauge'`, `'pictorialBar'`, `'themeRiver'`, `'custom'` 等。其中，部分系列默认没有填充色（如 `'line'`, `'radar'`, `'boxplot'`）需要在设置了填充样式 `areaStyle` 的情况下才生效。
+
### show(boolean) = false
是否显示贴花图案，默认不显示。如果要显示贴花，需要保证 [aria.enabled](~aria.enabled) 与 `aria.decal.show` 都是 `true`。
@@ -222,66 +224,6 @@ aria: {
贴花图案的样式。如果是 `Object` 类型，表示为所有数据采用同样的样式，如果是数组，则数组的每一项各为一种样式，数据将会依次循环取数组中的样式。
-#### symbol(string|string[]) = 'rect'
-
-贴花的图案，如果是 `string[]` 表示循环使用数组中的图案。
-
-{{ use: partial-icon() }}
-
-#### symbolSize(number) = 1
-
-取值范围：`0` 到 `1`，表示占图案区域的百分比。
-
-#### symbolKeepAspect(boolean) = true
-
-是否保持图案的长宽比。
-
-#### color(string) = 'rgba(0, 0, 0, 0.2)'
-
-贴花图案的颜色，建议使用半透明色，这样能叠加在系列本身的颜色上。
-
-#### backgroundColor(string) = null
-
-贴花的背景色，将会覆盖在系列本身颜色之上，贴花图案之下。
-
-#### dashArrayX(number | number[] | (number | number[])[]) = 5
-
-贴花图案的基本模式是在横向和纵向上分别以`图案 - 空白 - 图案 - 空白 - 图案 - 空白`的形式无限循环。通过设置每个图案和空白的长度，可以实现复杂的图案效果。
-
-`dashArrayX` 控制了横向的图案模式。当其值为 `number` 或 `number[]` 类型时，与 [SVG stroke-dasharray](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-dasharray) 类似。
-
-- 如果是 `number` 类型，表示图案和空白分别是这个值。如 `5` 表示先显示宽度为 5 的图案，然后空 5 像素，再然后显示宽度为 5 的图案……
-
-- 如果是 `number[]` 类型，则表示图案和空白依次为数组值的循环。如：`[5, 10, 2, 6]` 表示图案宽 5 像素，然后空 10 像素，然后图案宽 2 像素，然后空 6 像素，然后图案宽 5 像素……
-
-- 如果是 `(number | number[])[]` 类型，表示每行的图案和空白依次为数组值的循环。如：`[10, [2, 5]]` 表示第一行以图案 10 像素空 10 像素循环，第二行以图案 2 像素空 5 像素循环，第三行以图案 10 像素空 10 像素循环……
-
-可以结合以下的例子理解本接口：
-
-~[700x300](${galleryViewPath}doc-example/aria-decal&edit=1&reset=1)
-
-#### dashArrayY(number | number[]) = 5
-
-贴花图案的基本模式是在横向和纵向上分别以`图案 - 空白 - 图案 - 空白 - 图案 - 空白`的形式无限循环。通过设置每个图案和空白的长度，可以实现复杂的图案效果。
-
-`dashArrayY` 控制了横向的图案模式。与 [SVG stroke-dasharray](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-dasharray) 类似。
-
-- 如果是 `number` 类型，表示图案和空白分别是这个值。如 `5` 表示先显示高度为 5 的图案，然后空 5 像素，再然后显示高度为 5 的图案……
-
-- 如果是 `number[]` 类型，则表示图案和空白依次为数组值的循环。如：`[5, 10, 2, 6]` 表示图案高 5 像素，然后空 10 像素，然后图案高 2 像素，然后空 6 像素，然后图案高 5 像素……
-
-可以结合以下的例子理解本接口：
-
-~[700x300](${galleryViewPath}doc-example/aria-decal&edit=1&reset=1)
-
-#### rotation(number) = 0
-
-图案的整体旋转角度（弧度制），取值范围从 `-Math.PI` 到 `Math.PI`。
-
-#### maxTileWidth(number) = 512
-
-生成的图案在未重复之前的宽度上限。通常不需要设置该值，当你发现图案在重复的时候出现不连续的接缝时，可以尝试提高该值。
-
-#### maxTileHeight(number) = 512
-
-生成的图案在未重复之前的高度上限。通常不需要设置该值，当你发现图案在重复的时候出现不连续的接缝时，可以尝试提高该值。
+{{ use: partial-decal(
+ prefix = "###"
+) }}
diff --git a/zh/option/partial/decal.md b/zh/option/partial/decal.md
new file mode 100644
index 0000000..461fd81
--- /dev/null
+++ b/zh/option/partial/decal.md
@@ -0,0 +1,79 @@
+{{ target: partial-decal-desc }}
+
+图形的贴花图案，在 [aria.enabled](~aria.enabled) 与 [aria.decal.show](~aria.decal.show) 都是 `true` 的情况下才生效。
+
+如果为 `'none'` 表示不使用贴花图案。
+
+{{ if: ${onlyWithAreaStyle} }}
+
+需要在设置了填充样式 `areaStyle` 的情况下才生效。
+
+{{ /if }}
+
+
+
+{{ target: partial-decal }}
+
+#${prefix|default('#')} symbol(string|string[]) = 'rect'
+
+贴花的图案，如果是 `string[]` 表示循环使用数组中的图案。
+
+{{ use: partial-icon() }}
+
+#${prefix|default('#')} symbolSize(number) = 1
+
+取值范围：`0` 到 `1`，表示占图案区域的百分比。
+
+#${prefix|default('#')} symbolKeepAspect(boolean) = true
+
+是否保持图案的长宽比。
+
+#${prefix|default('#')} color(string) = 'rgba(0, 0, 0, 0.2)'
+
+贴花图案的颜色，建议使用半透明色，这样能叠加在系列本身的颜色上。
+
+#${prefix|default('#')} backgroundColor(string) = null
+
+贴花的背景色，将会覆盖在系列本身颜色之上，贴花图案之下。
+
+#${prefix|default('#')} dashArrayX(number | number[] | (number | number[])[]) = 5
+
+贴花图案的基本模式是在横向和纵向上分别以`图案 - 空白 - 图案 - 空白 - 图案 - 空白`的形式无限循环。通过设置每个图案和空白的长度，可以实现复杂的图案效果。
+
+`dashArrayX` 控制了横向的图案模式。当其值为 `number` 或 `number[]` 类型时，与 [SVG stroke-dasharray](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-dasharray) 类似。
+
+- 如果是 `number` 类型，表示图案和空白分别是这个值。如 `5` 表示先显示宽度为 5 的图案，然后空 5 像素，再然后显示宽度为 5 的图案……
+
+- 如果是 `number[]` 类型，则表示图案和空白依次为数组值的循环。如：`[5, 10, 2, 6]` 表示图案宽 5 像素，然后空 10 像素，然后图案宽 2 像素，然后空 6 像素，然后图案宽 5 像素……
+
+- 如果是 `(number | number[])[]` 类型，表示每行的图案和空白依次为数组值的循环。如：`[10, [2, 5]]` 表示第一行以图案 10 像素空 10 像素循环，第二行以图案 2 像素空 5 像素循环，第三行以图案 10 像素空 10 像素循环……
+
+可以结合以下的例子理解本接口：
+
+~[700x300](${galleryViewPath}doc-example/aria-decal&edit=1&reset=1)
+
+#${prefix|default('#')} dashArrayY(number | number[]) = 5
+
+贴花图案的基本模式是在横向和纵向上分别以`图案 - 空白 - 图案 - 空白 - 图案 - 空白`的形式无限循环。通过设置每个图案和空白的长度，可以实现复杂的图案效果。
+
+`dashArrayY` 控制了横向的图案模式。与 [SVG stroke-dasharray](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/stroke-dasharray) 类似。
+
+- 如果是 `number` 类型，表示图案和空白分别是这个值。如 `5` 表示先显示高度为 5 的图案，然后空 5 像素，再然后显示高度为 5 的图案……
+
+- 如果是 `number[]` 类型，则表示图案和空白依次为数组值的循环。如：`[5, 10, 2, 6]` 表示图案高 5 像素，然后空 10 像素，然后图案高 2 像素，然后空 6 像素，然后图案高 5 像素……
+
+可以结合以下的例子理解本接口：
+
+~[700x300](${galleryViewPath}doc-example/aria-decal&edit=1&reset=1)
+
+#${prefix|default('#')} rotation(number) = 0
+
+图案的整体旋转角度（弧度制），取值范围从 `-Math.PI` 到 `Math.PI`。
+
+#${prefix|default('#')} maxTileWidth(number) = 512
+
+生成的图案在未重复之前的宽度上限。通常不需要设置该值，当你发现图案在重复的时候出现不连续的接缝时，可以尝试提高该值。
+
+#${prefix|default('#')} maxTileHeight(number) = 512
+
+生成的图案在未重复之前的高度上限。通常不需要设置该值，当你发现图案在重复的时候出现不连续的接缝时，可以尝试提高该值。
diff --git a/zh/option/partial/item-style.md b/zh/option/partial/item-style.md
index 8060730..c009c10 100644
--- a/zh/option/partial/item-style.md
+++ b/zh/option/partial/item-style.md
@@ -50,3 +50,16 @@ ${name}描边线宽。为 0 时无描边。
defaultShadowOffsetY = ${defaultShadowOffsetY}
) }}
+{{ if: ${useDecal} }}
+
+#${prefix} decal(Object | 'none')
+
+{{ use: partial-decal-desc(
+ onlyWithAreaStyle = ${decalOnlyWithAreaStyle}
+) }}
+
+{{ use: partial-decal(
+ prefix = '#' + ${prefix}
+) }}
+
+{{ /if }}
diff --git a/zh/option/series/bar.md b/zh/option/series/bar.md
index f1a7dcc..7ea29e3 100644
--- a/zh/option/series/bar.md
+++ b/zh/option/series/bar.md
@@ -364,6 +364,7 @@ option = {
{{ use: partial-bar-item-style(
prefix = "#" + ${prefix},
useColorPalatte = ${topLevel && isNormal},
+ useDecal = ${isNormal},
hasCallback = ${topLevel && isNormal}
) }}
@@ -403,3 +404,15 @@ option = {
prefix = ${prefix}
) }}
+
+{{ if: ${useDecal} }}
+
+#${prefix} decal(Object | 'none')
+
+{{ use: partial-decal-desc() }}
+
+{{ use: partial-decal(
+ prefix = '#' + ${prefix}
+) }}
+
+{{ /if }}
diff --git a/zh/option/series/boxplot.md b/zh/option/series/boxplot.md
index a72b0a2..a91d193 100644
--- a/zh/option/series/boxplot.md
+++ b/zh/option/series/boxplot.md
@@ -103,7 +103,8 @@ box 的宽度的上下限。数组的意思是：`[min, max]`。
useColorPalatte = true,
name = "boxplot",
defaultColor = "#fff",
- defaultBorderWidth = 1
+ defaultBorderWidth = 1,
+ useDecal = true
) }}
## emphasis(Object)
@@ -215,7 +216,9 @@ ECharts 并不内置对原始数据的处理，输入给 `boxplot` 的数据须
{{ use: partial-item-style(
prefix = "###",
- name = "boxplot"
+ name = "boxplot",
+ useDecal = true,
+ decalOnlyWithAreaStyle = true
) }}
### emphasis(Object)
diff --git a/zh/option/series/custom.md b/zh/option/series/custom.md
index 37bc453..6d6f912 100644
--- a/zh/option/series/custom.md
+++ b/zh/option/series/custom.md
@@ -378,7 +378,8 @@ renderItem 函数的第二个参数。
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = false
+ hasCallback = false,
+ useDecal = true
) }}
## labelLine(Object)
@@ -430,7 +431,8 @@ renderItem 函数的第二个参数。
### itemStyle(Object)
{{ use: partial-item-style(
- prefix = "###"
+ prefix = "###",
+ useDecal = true
) }}
### emphasis(Object)
diff --git a/zh/option/series/funnel.md b/zh/option/series/funnel.md
index 652c362..c145bd3 100644
--- a/zh/option/series/funnel.md
+++ b/zh/option/series/funnel.md
@@ -124,7 +124,8 @@ option = {
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = true
+ hasCallback = true,
+ useDecal = true
) }}
## labelLayout(Object|Function)
@@ -207,14 +208,15 @@ option = {
{{ use: partial-item-style-desc() }}
-{{ use: partial-item-style(
- prefix = "###"
-) }}
-
#### height(string|number)
该数据项的高度。默认平均分配高度，如果需要修改，可以将其设为百分比（如：`'10%'`）或像素值（如：`20px`）。需要注意总和应为 100%。
+{{ use: partial-item-style(
+ prefix = "###",
+ useDecal = true
+) }}
+
### label(Object)
单个数据的标签配置。
@@ -232,14 +234,6 @@ option = {
length = true
) }}
-### itemStyle(Object)
-
-{{ use: partial-item-style-desc() }}
-
-{{ use: partial-item-style(
- prefix = "###"
-) }}
-
### emphasis(Object)
{{ use: partial-funnel-state(
diff --git a/zh/option/series/gauge.md b/zh/option/series/gauge.md
index 142a7bf..5ede002 100644
--- a/zh/option/series/gauge.md
+++ b/zh/option/series/gauge.md
@@ -77,6 +77,15 @@ const option = {
数据值。
+### itemStyle(Object)
+
+数据项的指针样式。
+
+{{ use: partial-item-style(
+ prefix = "###",
+ useDecal = true
+) }}
+
## min(number) = 0
<ExampleUIControlNumber default="0" step="1" />
@@ -411,14 +420,15 @@ formatter: function (value) {
仪表盘指针样式。
{{ use: partial-item-style(
- prefix = "##"
+ prefix = "##",
+ useDecal = true
) }}
<!-- overwrite color -->
### color(Color) = 'auto'
-指针颜色，默认取数值所在的[区间的颜色](~series-gauge.axisLine.lineStyle.color)
+指针颜色，默认取数值所在的[区间的颜色](~series-gauge.axisLine.lineStyle.color)。
## emphasis(Object)
@@ -529,7 +539,7 @@ formatter: function (value) {
<ExampleUIControlColor />
-文本颜色，默认取数值所在的[区间的颜色](~series-gauge.axisLine.lineStyle.color)
+文本颜色，默认取数值所在的[区间的颜色](~series-gauge.axisLine.lineStyle.color)。
##${prefix} backgroundColor(Color) = 'transparent'
diff --git a/zh/option/series/line.md b/zh/option/series/line.md
index 383830a..fe74251 100644
--- a/zh/option/series/line.md
+++ b/zh/option/series/line.md
@@ -161,7 +161,9 @@ const option = {
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = true
+ hasCallback = true,
+ useDecal = true,
+ decalOnlyWithAreaStyle = true
) }}
## lineStyle(Object)
diff --git a/zh/option/series/pictorialBar.md b/zh/option/series/pictorialBar.md
index a017fa7..96c430a 100644
--- a/zh/option/series/pictorialBar.md
+++ b/zh/option/series/pictorialBar.md
@@ -154,7 +154,8 @@ option = {
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = false
+ hasCallback = false,
+ useDecal = true
) }}
## emphasis(Object)
@@ -253,7 +254,8 @@ option = {
### itemStyle(Object)
{{ use: partial-item-style(
- prefix = "###"
+ prefix = "###",
+ useDecal = true
) }}
### emphasis(Object)
diff --git a/zh/option/series/pie.md b/zh/option/series/pie.md
index 5597fb2..c59535a 100644
--- a/zh/option/series/pie.md
+++ b/zh/option/series/pie.md
@@ -201,7 +201,8 @@ const option = {
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = true
+ hasCallback = true,
+ useDecal = true
) }}
## emphasis(Object)
@@ -309,7 +310,8 @@ const option = {
{{ use: partial-item-style-desc() }}
{{ use: partial-item-style(
- prefix = "###"
+ prefix = "###",
+ useDecal = true
) }}
### emphasis(Object)
diff --git a/zh/option/series/radar.md b/zh/option/series/radar.md
index f85d9ca..fd0c2f8 100644
--- a/zh/option/series/radar.md
+++ b/zh/option/series/radar.md
@@ -90,7 +90,9 @@ const option = {
{{ use: partial-item-style(
prefix = "##",
useColorPalatte = true,
- hasCallback = true
+ hasCallback = true,
+ useDecal = true,
+ decalOnlyWithAreaStyle = true
) }}
## lineStyle(Object)
diff --git a/zh/option/series/sankey.md b/zh/option/series/sankey.md
index b8d0610..1adfddb 100644
--- a/zh/option/series/sankey.md
+++ b/zh/option/series/sankey.md
@@ -187,7 +187,8 @@ levels: [{
prefix = "##",
useColorPalatte = true,
defaultBorderWidth = 1,
- defaultBorderColor = "'#aaa'"
+ defaultBorderColor = "'#aaa'",
+ useDecal = true
) }}
## lineStyle(Object)
@@ -275,7 +276,8 @@ data: [{
{{ use: partial-item-style(
prefix = "###",
- useColorPalatte = true
+ useColorPalatte = true,
+ useDecal = true
) }}
### label(Object)
@@ -435,7 +437,8 @@ links: [{
#${prefix} itemStyle(Object)
{{ use: partial-item-style(
- prefix = "#" + ${prefix}
+ prefix = "#" + ${prefix},
+ useDecal = true
) }}
diff --git a/zh/option/series/sunburst.md b/zh/option/series/sunburst.md
index a4392bc..da57503 100644
--- a/zh/option/series/sunburst.md
+++ b/zh/option/series/sunburst.md
@@ -91,7 +91,8 @@
useColorPalatte = true,
defaultBorderWidth = 1,
defaultBorderColor = "'white'",
- defaultOpacity = 1
+ defaultOpacity = 1,
+ useDecal = ${isNormal}
) }}
@@ -349,19 +350,16 @@ const option = {
意义同 HTML `<a>` 标签中的 `target`，参见 [series-sunburst.data.link](~series-sunburst.data.link)。可选值为：`'blank'` 或 `'self'`。
-{{ use: partial-sunburst-label-props(
+{{ use: partial-sunburst-state(
prefix = "##",
isNormal = true
) }}
## labelLayout(Object|Function)
-{{ use: partial-label-layout(
- prefix = "##"
-) }}
-
-{{ use: partial-sunburst-itemStyle-props(
- prefix = "##"
+{{ use: partial-sunburst-state(
+ prefix = "#",
+ isNormal = true
) }}
### emphasis
@@ -426,7 +424,8 @@ function(nodeA, nodeB) {
) }}
{{ use: partial-sunburst-itemStyle-props(
- prefix = "#"
+ prefix = "#",
+ isNormal = true
) }}
## emphasis
diff --git a/zh/option/series/themeRiver.md b/zh/option/series/themeRiver.md
index f2fc261..4fb8780 100644
--- a/zh/option/series/themeRiver.md
+++ b/zh/option/series/themeRiver.md
@@ -163,7 +163,8 @@ const option = {
主题河流中每个带状河流分支的样式。
{{ use: partial-item-style(
- prefix = "##"
+ prefix = "##",
+ useDecal = true
) }}
## emphasis(Object)
diff --git a/zh/option/series/treemap.md b/zh/option/series/treemap.md
index 8929464..5975ab9 100644
--- a/zh/option/series/treemap.md
+++ b/zh/option/series/treemap.md
@@ -863,6 +863,15 @@ treemap 默认把第一个维度（Array 第一项）映射到『面积』上。
{{ use: partial-style-shadow-opacity(
prefix = ${prefix}
) }}
+
+#${prefix} decal(Object | 'none')
+
+{{ use: partial-decal-desc() }}
+
+{{ use: partial-decal(
+ prefix = '#' + ${prefix}
+) }}
+
{{ /if }}
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@echarts.apache.org
For additional commands, e-mail: commits-help@echarts.apache.org