This is an automated email from the ASF dual-hosted git repository.
100pah pushed a commit to branch v6.1.0
in repository https://gitbox.apache.org/repos/asf/echarts-doc.git
The following commit(s) were added to refs/heads/v6.1.0 by this push:
new c5cbc3ca supplement doc for v6.1.0
c5cbc3ca is described below
commit c5cbc3caf3c1bf4626fb26076b1c890f8ba279e6
Author: 100pah <[email protected]>
AuthorDate: Mon May 25 02:46:32 2026 +0800
supplement doc for v6.1.0
---
en/option/component/axis-common.md | 4 +++-
en/option/partial/item-style.md | 2 ++
en/option/partial/matrix-header.md | 13 +++++++++++--
en/option/partial/tooltip-common.md | 6 +++++-
en/option/partial/version.md | 2 +-
en/option/series/bar.md | 2 +-
en/option/series/gauge.md | 4 +++-
en/option/series/pictorialBar.md | 2 +-
zh/option/component/axis-common.md | 4 +++-
zh/option/partial/item-style.md | 2 ++
zh/option/partial/matrix-header.md | 12 ++++++++++--
zh/option/partial/tooltip-common.md | 8 ++++++--
zh/option/partial/version.md | 2 +-
zh/option/series/bar.md | 2 ++
zh/option/series/gauge.md | 4 +++-
zh/option/series/pictorialBar.md | 2 +-
16 files changed, 55 insertions(+), 16 deletions(-)
diff --git a/en/option/component/axis-common.md
b/en/option/component/axis-common.md
index 84c1a82e..a7b41ad6 100644
--- a/en/option/component/axis-common.md
+++ b/en/option/component/axis-common.md
@@ -808,7 +808,7 @@ Option:
Time axis, suitable for continuous time series data. As compared to value
axis, it has a better formatting for time and a different tick calculation
method. For example, it decides to use month, week, day or hour for tick based
on the range of span.
+ `'log'`
- Log axis, suitable for log data. Stacked bar or line series with `type:
'log'` axes may lead to significant visual errors and may have unintended
effects in certain circumstances. Their use should be avoided.
+ Logarithmic axis. It is useful when the data spans a very large range of
values or when the important pattern is about multiplicative change rather than
additive change.
{{ target: axis-common }}
@@ -1241,6 +1241,8 @@ Example:
formatter: '{value} kg'
// Use callback.
formatter: function (value, index, extra?) {
+ // Notice: when using `customValues`, parameter `index` is
+ // provided since `v6.1.0`.
return value + 'kg';
}
```
diff --git a/en/option/partial/item-style.md b/en/option/partial/item-style.md
index 329085bb..204b0989 100644
--- a/en/option/partial/item-style.md
+++ b/en/option/partial/item-style.md
@@ -23,6 +23,8 @@ Supports callback functions, in the form of:
Input parameters are `seriesIndex`, `dataIndex`, `data`, `value`, and etc. of
data item.
{{ /if }}
+${colorExtraInfo}
+
#${prefix} borderColor(Color) = ${defaultBorderColor|default("'#000'")}
<ExampleUIControlColor />
diff --git a/en/option/partial/matrix-header.md
b/en/option/partial/matrix-header.md
index cc1aeed2..f97f2bbf 100644
--- a/en/option/partial/matrix-header.md
+++ b/en/option/partial/matrix-header.md
@@ -44,9 +44,9 @@ data: [{
}]
```
-If [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) is not provided, it
will be collected from `series.data` or `dataset.soruce`.
+If [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) is not provided, and
[matrix.${matrixDim}.length](~matrix.${matrixDim}.length) is provided, a
[matrix.${matrixDim}.data](~matrix.${matrixDim}.data) is automatically composed
according to [matrix.${matrixDim}.length](~matrix.${matrixDim}.length).
-See [matrix data collection
example](${galleryEditorPath}matrix-mini-bar-data-collection&edit=1&reset=1).
+Otherwise, if either of them are provided,
[matrix.${matrixDim}.data](~matrix.${matrixDim}.data) will be automatically
collected from `series.data` or `dataset.source`. See [matrix data collection
example](${galleryEditorPath}matrix-mini-bar-data-collection&edit=1&reset=1).
And in this case [series.encode](~series-scatter.encode) can be used to
specify the dimension from which value is collected. For example,
```js
@@ -81,6 +81,15 @@ See [matrix.${matrixDim}.data](~matrix.${matrixDim}.data).
{{ use: partial-matrix-dimension-size-desc }}
+### length(number)
+
+{{ use: partial-version(version = "6.1.0") }}
+
+Users can omit [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) but only
provide a [matrix.${matrixDim}.length](~matrix.${matrixDim}.length), which
defines the {{ if: ${matrixDim} === 'x' }}column{{ else }}row{{ /if }} number.
This is useful for headless matrix (i.e.,
[matrix.${matrixDim}.show](~matrix.${matrixDim}.show) is `false`), where only
column and row number need to be specified.
+
+Note: [matrix.${matrixDim}.length](~matrix.${matrixDim}.length) is ignored if
[matrix.${matrixDim}.data](~matrix.${matrixDim}.data) is specified.
+
+
{{ use: partial-matrix-cell-style-option(
prefix='##',
name=${name}
diff --git a/en/option/partial/tooltip-common.md
b/en/option/partial/tooltip-common.md
index 33b0856f..f53d24a5 100644
--- a/en/option/partial/tooltip-common.md
+++ b/en/option/partial/tooltip-common.md
@@ -396,9 +396,13 @@ Interface:
```
{{ use: partial-version(
- feature = '`dataIndex` is provided',
+ feature = '`dataIndex` is provided; but not reasonable when `dataZoom`
exists, since it is the index after dataZoom filtering.',
version = '5.5.0'
) }}
+{{ use: partial-version(
+ feature = '`dataIndex` is corrected to the index before `dataZoom`
filtering.',
+ version = '6.1.0'
+) }}
Example:
```ts
diff --git a/en/option/partial/version.md b/en/option/partial/version.md
index 04430156..29c2868e 100644
--- a/en/option/partial/version.md
+++ b/en/option/partial/version.md
@@ -5,7 +5,7 @@
{{ if: ${deprecated} }}
Deprecated since `v${version}`. ${deprecated}
{{ elif: ${feature} }}
-${feature} since `v${version}`
+Since `v${version}` ${feature}
{{ else }}
Since `v${version}`
{{ /if }}
diff --git a/en/option/series/bar.md b/en/option/series/bar.md
index 5f6327f8..915b9e88 100644
--- a/en/option/series/bar.md
+++ b/en/option/series/bar.md
@@ -5,7 +5,7 @@
**bar chart**
-Bar chart shows different data through the height of a bar, which is used in
[rectangular coordinate](~grid) with at least 1 category axis.
+Bar chart shows different data through the height of a bar. Currently it can
only be used in [Cartesian coordinate system (i.e., grid component)](~grid) or
[polar coordinate system](~polar).
## type(string) = 'bar'
diff --git a/en/option/series/gauge.md b/en/option/series/gauge.md
index 10123642..9b4ffa9d 100644
--- a/en/option/series/gauge.md
+++ b/en/option/series/gauge.md
@@ -195,7 +195,9 @@ Whether to clip overflow.
The style of progress.
{{ use: partial-item-style(
- prefix = "###"
+ prefix = "###",
+ defaultColor = "'auto'",
+ colorExtraInfo = "Notice: value 'auto' is supported since `v6.1.0`"
) }}
## splitLine(Object)
diff --git a/en/option/series/pictorialBar.md b/en/option/series/pictorialBar.md
index e4671277..319db1dc 100644
--- a/en/option/series/pictorialBar.md
+++ b/en/option/series/pictorialBar.md
@@ -7,7 +7,7 @@
Pictorial bar chart is a type of bar chart that customized glyph (like images,
[SVG PathData](http://www.w3.org/TR/SVG/paths.html#PathData)) can be used
instead of rectangular bar. This kind of chart is usually used in infographic.
-Pictorial bar chart can only be used in [rectangular coordinate](~grid) with
at least 1 category axis.
+Pictorial bar chart can only be used in [Cartesian coordinate system (i.e.,
grid component)](~grid).
**Example:**
diff --git a/zh/option/component/axis-common.md
b/zh/option/component/axis-common.md
index 75500cd8..cef78ec8 100644
--- a/zh/option/component/axis-common.md
+++ b/zh/option/component/axis-common.md
@@ -806,7 +806,7 @@ splitLine: {
时间轴，适用于连续的时序数据，与数值轴相比时间轴带有时间的格式化，在刻度计算上也有所不同，例如会根据跨度的范围来决定使用月，星期，日还是小时范围的刻度。
+ `'log'`
- 对数轴。适用于对数数据。对数轴下的堆积柱状图或堆积折线图可能带来很大的视觉误差，并且在一定情况下可能存在非预期效果，应避免使用。
+ 对数轴。当数据跨越非常大的数值范围时，或者数据中一些重要模式往往呈现“倍数变化”时，可考虑使用。
{{ target: axis-common }}
@@ -1236,6 +1236,8 @@ ${name}的显示间隔，在类目轴中有效。{{ if: !${isAxisLabel} }}默认
formatter: '{value} kg'
// 使用函数模板，函数参数分别为刻度数值（类目），刻度的索引
formatter: function (value, index, extra?) {
+ // 注意：当使用 `customValues` 时，自从 `v6.1.0`，
+ // 这里才会提供 `index`。
return value + 'kg';
}
```
diff --git a/zh/option/partial/item-style.md b/zh/option/partial/item-style.md
index be4c5432..a974995d 100644
--- a/zh/option/partial/item-style.md
+++ b/zh/option/partial/item-style.md
@@ -23,6 +23,8 @@ ${name}图形的颜色。{{ if: ${useColorPalatte} }} 默认从全局调色盘 [
传入的是数据项 `seriesIndex`, `dataIndex`, `data`, `value` 等各个参数。
{{ /if }}
+${colorExtraInfo}
+
#${prefix} borderColor(Color) = ${defaultBorderColor|default("'#000'")}
<ExampleUIControlColor />
diff --git a/zh/option/partial/matrix-header.md
b/zh/option/partial/matrix-header.md
index 16cf09f9..fcc4867e 100644
--- a/zh/option/partial/matrix-header.md
+++ b/zh/option/partial/matrix-header.md
@@ -44,9 +44,9 @@ data: [{
}]
```
-如果 [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) 没有提供，它会从
`series.data` 或者 `dataset.source` 中自动收集。
+如果 [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) 没有提供，且
[matrix.${matrixDim}.length](~matrix.${matrixDim}.length)
提供了，[matrix.${matrixDim}.data](~matrix.${matrixDim}.data) 会自动基于
[matrix.${matrixDim}.length](~matrix.${matrixDim}.length) 构造出来。
-参见 [示例](${galleryEditorPath}matrix-mini-bar-data-collection&edit=1&reset=1)。
+否则，如果它们都没有提供，则 [matrix.${matrixDim}.data](~matrix.${matrixDim}.data) 会从
`series.data` 或者 `dataset.source` 中自动收集出来。参见
[示例](${galleryEditorPath}matrix-mini-bar-data-collection&edit=1&reset=1)。
在这种情况下，[series.encode](~series-scatter.encode) 可指定从哪个维度收集数据。例如：
```js
@@ -84,6 +84,14 @@ var option = {
{{ use: partial-matrix-dimension-size-desc }}
+### length(number)
+
+{{ use: partial-version(version = "6.1.0") }}
+
+[matrix.${matrixDim}.data](~matrix.${matrixDim}.data) 可不提供，而只提供
[matrix.${matrixDim}.length](~matrix.${matrixDim}.length) 来决定{{ if:
${matrixDim} === 'x' }}列{{ else }}行{{ /if }}数。这种方式方便了无头矩阵（即
[matrix.${matrixDim}.show](~matrix.${matrixDim}.show) 为 `false`
时）的创建，这种情况下只有行列数需要提供。
+
+注：如果提供了 [matrix.${matrixDim}.data](~matrix.${matrixDim}.data)，则
[matrix.${matrixDim}.length](~matrix.${matrixDim}.length)会被忽略。
+
{{ use: partial-matrix-cell-style-option(
prefix='##',
diff --git a/zh/option/partial/tooltip-common.md
b/zh/option/partial/tooltip-common.md
index 0bd352ed..cade2c00 100644
--- a/zh/option/partial/tooltip-common.md
+++ b/zh/option/partial/tooltip-common.md
@@ -401,8 +401,12 @@ tooltip 中数值显示部分的格式化回调函数。
```
{{ use: partial-version(
- feature = '`dataIndex` 参数',
- version = '5.3.0'
+ feature = '`dataIndex` 参数。但是其值当 `dataZoom` 存在时不合理，因为所取的值是数据被 `dataZoom`
过滤后的 index。',
+ version = '5.5.0'
+) }}
+{{ use: partial-version(
+ feature = '`dataIndex` 参数修正 `dataZoom` 过滤前的 index',
+ version = '6.1.0'
) }}
示例：
diff --git a/zh/option/partial/version.md b/zh/option/partial/version.md
index ddd5265a..1365bd06 100644
--- a/zh/option/partial/version.md
+++ b/zh/option/partial/version.md
@@ -5,7 +5,7 @@
{{ if: ${deprecated} }}
从 `v${version}` 开始不推荐使用（deprecated）。${deprecated}
{{ elif: ${feature} }}
-${feature} 从 `v${version}` 开始支持
+从 `v${version}` 开始支持${feature}
{{ else }}
从 `v${version}` 开始支持
{{ /if }}
diff --git a/zh/option/series/bar.md b/zh/option/series/bar.md
index eb18e1a4..95e9b842 100644
--- a/zh/option/series/bar.md
+++ b/zh/option/series/bar.md
@@ -7,6 +7,8 @@
柱状图（或称条形图）是一种通过柱形的高度（横向的情况下则是宽度）来表现数据大小的一种常用图表类型。
+当前只支持用在 [直角坐标系（即 grid 组件）](~grid) 或 [极坐标](~polar) 上。
+
<ExampleBaseOption name="cartesian-bar" title="直角坐标系上的柱状图" title-en="Bar on
Cartesian">
const option = {
diff --git a/zh/option/series/gauge.md b/zh/option/series/gauge.md
index d235567c..5d8a11ad 100644
--- a/zh/option/series/gauge.md
+++ b/zh/option/series/gauge.md
@@ -208,7 +208,9 @@ color: [
进度条样式。
{{ use: partial-item-style(
- prefix = "###"
+ prefix = "###",
+ defaultColor = "'auto'",
+ colorExtraInfo = "自 `v6.1.0` 起 'auto' 才被支持。"
) }}
## splitLine(Object)
diff --git a/zh/option/series/pictorialBar.md b/zh/option/series/pictorialBar.md
index e042a4b5..7c5fd0c6 100644
--- a/zh/option/series/pictorialBar.md
+++ b/zh/option/series/pictorialBar.md
@@ -5,7 +5,7 @@
**象形柱图**
-象形柱图是可以设置各种具象图形元素（如图片、[SVG
PathData](http://www.w3.org/TR/SVG/paths.html#PathData)
等）的柱状图。往往用在信息图中。用于有至少一个类目轴或时间轴的[直角坐标系](~grid)上。
+象形柱图是可以设置各种具象图形元素（如图片、[SVG
PathData](http://www.w3.org/TR/SVG/paths.html#PathData) 等）的柱状图。往往用在信息图中。目前只支持用于
[直角坐标系（即grid 组件）](~grid) 上。
**示例：**
~[800x400](${galleryViewPath}pictorialBar-hill&reset=1&edit=1)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
