This is an automated email from the ASF dual-hosted git repository.
sushuang pushed a commit to branch feat-coord-sys
in repository https://gitbox.apache.org/repos/asf/echarts-doc.git
commit 39fa6dc638bad8d23c074fee3317c476925de0cb
Author: 100pah <sushuang0...@gmail.com>
AuthorDate: Mon Aug 4 17:37:38 2025 +0800
feat(coordSys): add and enhance coord sys doc.
---
README.md | 3 +-
en/option/partial/coord-sys.md | 186 +++++++++++++++++++++++++++++++++-------
zh/option/partial/coord-sys.md | 189 ++++++++++++++++++++++++++++++++++-------
3 files changed, 319 insertions(+), 59 deletions(-)
diff --git a/README.md b/README.md
index 3c406784..1ae56658 100644
--- a/README.md
+++ b/README.md
@@ -223,7 +223,8 @@ Declaration or assignment of a target-local variable:
{{ var: myVar = 'some' }}
{{ var: myVar = 123 }}
{{ var: myVar = ${someOtherStr} + 'some_str' }}
-
+NOTICE:
+ Within a `{{` `}}` pair, DO NOT write {{ if: '${some}_abc' }}{{ /if }}. It
should be {{ if: ${some} + '_abc' }}{{ /if }}, as the sentence within `{{` `}}`
pair is treated like a normal JS expression.
--- IF ELSE ---
{{ if: ${number1} > 0 }}
diff --git a/en/option/partial/coord-sys.md b/en/option/partial/coord-sys.md
index 7ba38ccc..1377ec9a 100644
--- a/en/option/partial/coord-sys.md
+++ b/en/option/partial/coord-sys.md
@@ -1,63 +1,191 @@
{{ target: partial-coord-sys }}
+{{ if: ${seriesType} }}
+{{ var: componentNameInLink = 'series-' + ${seriesType} }}
+{{ elif: ${nonSeriesComponentSubType} }}
+{{ var: componentNameInLink = ${nonSeriesComponentMainType} + '-' +
${nonSeriesComponentSubType} }}
+{{ else }}
+{{ var: componentNameInLink = ${nonSeriesComponentMainType} }}
+{{ /if }}
+
+{{ if: ${coordSysUsageSupportData} == null }}
+{{ if: ${seriesType} }}
+{{ var: coordSysUsageSupportData = true }}
+{{ /if }}
+{{ /if }}
+
+{{ if: ${coordSysUsageSupportBox} == null }}
+{{ if: ${nonSeriesComponentMainType} }}
+{{ var: coordSysUsageSupportBox = true }}
+{{ /if }}
+{{ /if }}
+
+{{ if: ${coordSysUsageDefault} == null }}
+{{ if: ${coordSysUsageSupportData} }}
+{{ var: coordSysUsageDefault = "'data'" }}
+{{ else }}
+{{ var: coordSysUsageDefault = "'box'" }}
+{{ /if }}
+{{ /if }}
+
+
## coordinateSystem(string) = ${coordSysDefault}
{{ if: ${version} }}
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-The coordinate system used in the series or component, whose options are:
+Specifies another coordinate system component on which this
`${componentNameInLink}` is laid out.
+
+Options:
{{ if: ${none} }}
+ `null`/`undefined`/`'none'`
- Do not use coordinate system.
+ Not laid out in any coordinate system; instead, laid out independently.
{{ /if }}
{{ if: ${cartesian2d} }}
+ `'cartesian2d'`
- Use a two-dimensional [rectangular coordinate system (also known as
Cartesian coordinate system)](~grid), with
[xAxisIndex](~series-${seriesType}.xAxisIndex) and
[yAxisIndex](~series-${seriesType}.yAxisIndex) or
[xAxisId](~series-${seriesType}.xAxisId) and
[yAxisId](~series-${seriesType}.yAxisId) to assign the corresponding axis
component.
+ Lay out based on a two-dimensional [rectangular coordinate system (also
known as Cartesian coordinate system)](~grid). When multiple `xAxis` or
multiple `yAxis` exist within an ECharts instance, the corresponding axes
should be specified using [xAxisIndex](~${componentNameInLink}.xAxisIndex) and
[yAxisIndex](~${componentNameInLink}.yAxisIndex) or
[xAxisId](~${componentNameInLink}.xAxisId) and
[yAxisId](~${componentNameInLink}.yAxisId).
+
+ Note: some commonly used series, such as [series-line](~series-line),
[series-bar](~series-bar), etc., can not be laid out directly based on [matrix
coordinate system](~matrix) or [calendar coordinate system](~calendar), but
they can be laid out on a [grid(Cartesian)](~grid), and that [grid](~grid) can
be laid out on a [matrix](~matrix) or [calendar](~calendar).
{{ /if }}
{{ if: ${polar} }}
+ `'polar'`
- Use [polar coordinate system](~polar), with
[polarIndex](~series-${seriesType}.polarIndex) or
[polarId](~series-${seriesType}.polarId) to assign the corresponding polar
coordinate system component.
+ Lay out based on a [polar coordinate system](~polar). When multiple polar
coordinate systems exist within an ECharts instance, the corresponding system
should be specified using [polarIndex](~${componentNameInLink}.polarIndex) or
[polarId](~${componentNameInLink}.polarId).
{{ /if }}
-{{ if: ${singleAxis} }}
-+ `'singleAxis'`
+{{ if: ${geo} }}
++ `'geo'`
+
+ Lay out based on a [geographic coordinate system](~geo). When multiple
geographic coordinate systems exist within an ECharts instance, the
corresponding system should be specified using
[geoIndex](~${componentNameInLink}.geoIndex) or
[geoId](~${componentNameInLink}.geoId).{{ if: ${seriesType} === 'pie' }}
- Use [singleAxis coordinate system](~singleAxis), with
[singleAxisIndex](~series-${seriesType}.polarIndex) or
[singleAxisId](~series-${seriesType}.polarId) to assign the corresponding
`singleAxis` coordinate system component.
+ See example [pie in
geo](${galleryEditorPath}map-iceland-pie&edit=1&reset=1).{{ /if }}
{{ /if }}
-{{ if: ${geo} }}
-+ `'geo'`
+{{ if: ${singleAxis} }}
++ `'singleAxis'`
- Use [geographic coordinate system](~geo), with
[geoIndex](~series-${seriesType}.geoIndex) or
[geoId](~series-${seriesType}.geoId) to assign the corresponding geographic
coordinate system components.
+ Lay out based on a [singleAxis coordinate system](~singleAxis). When
multiple singleAxis coordinate systems exist within an ECharts instance, the
corresponding system should be specified using
[singleAxisIndex](~${componentNameInLink}.polarIndex) or
[singleAxisId](~${componentNameInLink}.polarId).
{{ /if }}
{{ if: ${parallel} }}
+ `'parallel'`
- Use [parallel coordinate system](~parallel), with
[parallelIndex](~series-${seriesType}.parallelIndex) or
[parallelId](~series-${seriesType}.parallelId) to assign the corresponding
parallel coordinate system components.
+ Lay out based on a [parallel coordinate system](~parallel). When multiple
parallel coordinate systems exist within an ECharts instance, the corresponding
system should be specified using
[parallelIndex](~${componentNameInLink}.parallelIndex) or
[parallelId](~${componentNameInLink}.parallelId).
{{ /if }}
{{ if: ${calendar} }}
+ `'calendar'`
- Use [calendar coordinate system](~calendar), with
[calendarIndex](~series-${seriesType}.calendarIndex) or
[calendarId](~series-${seriesType}.calendarId) to assign the corresponding
calendar coordinate system components.
+ Lay out based on a [calendar coordinate system](~calendar). When multiple
calendar coordinate systems exist within an ECharts instance, the corresponding
system should be specified using
[calendarIndex](~${componentNameInLink}.calendarIndex) or
[calendarId](~${componentNameInLink}.calendarId).
{{ /if }}
{{ if: ${matrix} }}
+ `'matrix'`
- Use [matrix coordinate system](~matrix), with
[matrixIndex](~series-${seriesType}.matrixIndex) or
[matrixId](~series-${seriesType}.matrixId) to assign the corresponding matrix
coordinate system components.
+ Lay out based on a [matrix coordinate system](~matrix). When multiple
matrix coordinate systems exist within an ECharts instance, the corresponding
system should be specified using
[matrixIndex](~${componentNameInLink}.matrixIndex) or
[matrixId](~${componentNameInLink}.matrixId).{{if:
${nonSeriesComponentMainType} === 'grid' }}
+
+ See example [tiny Cartesians in
matrix](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1).
+ {{ /if }}
{{ /if }}
+**Support for series and component layout on coordinate systems:**
+
+The leftmost column lists the series and components that will be laid out
(coordinate systems themselves are also components), and the topmost row lists
the coordinate systems that can be laid out on.
+
+| | no coord sys | [grid](~grid) (cartesian2d) |
[polar](~polar) | [geo](~geo) | [singleAxis](~singleAxis) | [radar](~radar) |
[parallel](~parallel) | [calendar](~calendar) | [matrix](~matrix) |
+|------------------------------------------------|----------|----------|---------|----------|----------|----------|----------|
+| [grid](~grid) (cartesian2d) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [polar](~polar) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [geo](~geo) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [singleAxis](~singleAxis) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [calendar](~calendar) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ | ❌ |
+| [matrix](~matrix) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ | ❌ |
+| [series-line](~series-line) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ if via another coord sys like [grid](~grid)) | ❌ (✅ if via another coord
sys like [grid](~grid)) |
+| [series-bar](~series-bar) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ if via another coord sys like [grid](~grid)) | ❌ (✅ if via another coord
sys like [grid](~grid)) |
+| [series-pie](~series-pie) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-scatter](~series-scatter) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-effectScatter](~series-effectScatter) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-radar](~series-radar) | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
❌ (✅ if via [radar](~radar) coord sys) | ❌ (✅ if via [radar](~radar) coord sys)
|
+| [series-tree](~series-tree) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-treemap](~series-treemap) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-sunburst](~series-sunburst) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-boxplot](~series-boxplot) | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ if via another coord sys like [grid](~grid)) | ❌ (✅ if via another coord
sys like [grid](~grid)) |
+| [series-candlestick](~series-candlestick) | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ if via another coord sys like [grid](~grid)) | ❌ (✅ if via another coord
sys like [grid](~grid)) |
+| [series-heatmap](~series-heatmap) | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-map](~series-map) | ✅ (create a geo coord sys
exclusively) | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| [series-parallel](~series-parallel) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
❌ (✅ if via [parallel](~parallel) coord sys) | ❌ (✅ if via
[parallel](~parallel) coord sys) |
+| [series-lines](~series-lines) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
❌ (✅ if via another coord sys like [geo](~geo)) | ❌ (✅ if via another coord sys
like [geo](~geo)) |
+| [series-graph](~series-graph) | ✅ (create a "view" coord sys
exclusively) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| [series-sankey](~series-sankey) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌
| ✅ | ✅ |
+| [series-funnel](~series-funnel) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌
| ✅ | ✅ |
+| [series-gauge](~series-gauge) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-pictorialBar](~series-pictorialBar) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ if via another coord sys like [grid](~grid)) | ❌ (✅ if via another coord
sys like [grid](~grid)) |
+| [series-themeRiver](~series-themeRiver) | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
❌ (✅ if via another coord sys like [singleAxis](~singleAxis)) | ❌ (✅ if via
another coord sys like [singleAxis](~singleAxis)) |
+| [series-chord](~series-chord) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [title](~title) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [legend](~legend) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [dataZoom](~dataZoom) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [visualMap](~visualMap) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [toolbox](~toolbox) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [timeline](~timeline) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [thumbnail](~thumbnail) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+
+See also
[${componentNameInLink}.coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage).
+
+
+## coordinateSystemUsage(string) = ${coordSysUsageDefault}
+
+{{ use: partial-version(version = ${version|minVersion('6.0.0')}) }}
+
+Specify how to lay out this `${componentNameInLink}` based on the specified
[coordinateSystem](~${componentNameInLink}.coordinateSystem).
+
+In most cases, there is no need to specify `coordinateSystemUsage`, unless the
default behavior is unexpected.
+
+Options:
+- `'data'`: {{ if: !${coordSysUsageSupportData} }}**(Not applicable in
[${componentNameInLink}](~${componentNameInLink}))**{{ /if }}
+
+ Each data item of a series (e.g., each `series.data[i]`) is laid out
separately based on the specified coordinate system. Currently no non-series
component supports `coordinateSystemUsage: 'data'`.
+
+- `'box'`: {{ if: !${coordSysUsageSupportBox} }}**(Not applicable in
[${componentNameInLink}](~${componentNameInLink}))**{{ /if }}
+
+ The entire series or component is laid out as a whole based on the
specified coordinate system - that is, the overall bounding rect or basic
anchor point is calculated relative to the system.
+
+ - For example, a [grid component](~grid) can be laid out in a [matrix
coordinate system](~matrix) or a [calendar coordinate system](~calendar), where
its layout rectangle is calculated by the specified
[${componentNameInLink}.coords](~${componentNameInLink}.coords) in that system.
See example [tiny Cartesians in
matrix](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1).
+ - For example, a [pie series](~series-pie) or a [chord
series](~series-chord) can be laid out in a [geo coordinate system](~geo) or a
[cartesian2d coordinate system](~grid), where the center is calculated by the
specified [series-pie.coords](~series-pie.coords) or
[series-pie.center](~series-pie.center) in that system. See example [pie in
geo](${galleryEditorPath}map-iceland-pie&edit=1&reset=1).
+
+{{ if: ${seriesType} }}
+Only a few series support both `coordinateSystemUsage: 'data'` and
`coordinateSystemUsage: 'box'`, such as [series-graph](~series-graph),
[series-map](~series-map). For examle, in [this example (coordinateSystemUsage:
'data')](${galleryEditorPath}matrix-graph&edit=1&reset=1), each node of a graph
series is laid out on a matrix coordinate system, while in [this example
(coordinateSystemUsage:
'box')](${galleryEditorPath}doc-example/matrix-graph-box&edit=1&reset=1), the
entire graph series [...]
+
+Most series only support `coordinateSystemUsage: 'data'` - such as
[series-line](~series-line), [series-bar](~series-bar),
[series-scatter](~series-scatter), etc. Meanwhile, some series only support
`coordinateSystemUsage: 'box'` - such as [series-pie](~series-pie) ([example:
pie in geo](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)),
[series-tree](~series-pie), [series-treemap](~series-treemap),
[series-sankey](~series-sankey), etc.
+{{ /if }}
+
+See also
[${componentNameInLink}.coordinateSystem](~${componentNameInLink}.coordinateSystem).
+
+## coord(Array|string)
+
+{{ use: partial-version(version = ${version|minVersion('6.0.0')}) }}
+
+When [coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage) is
`'box'`, `coord` is used as the input to the coordinate system and calculate
the layout rectangle or anchor point.
+
+Examples: [tiny Cartesians in
matrix](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1), [grpah in
matrix](${galleryEditorPath}doc-example/matrix-graph-box&edit=1&reset=1).
+
+{{ if: ${seriesType} === 'pie' }}
+[series-pie.center](~series-pie.center) and
[series-pie.coord](~series-pie.coord) can be used interchangably in this case.
+
+[example: pie in geo](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)
+{{ /if }}
+
+> Note: when
[coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage) is
`'data'`, the input of coordinate system is `series.data[i]` rather than this
`coord`.
+
+
{{ if: ${cartesian2d} }}
## xAxisIndex(number) = 0
@@ -65,7 +193,7 @@ The coordinate system used in the series or component, whose
options are:
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [x axis](~xAxis) to combine with, which is useful for multiple x axes
in one chart.
+The index of the [xAxis](~xAxis) to base on. When mutiple `xAxis` components
exist within an ECharts instance, use this to specify the corresponding `xAxis`.
## xAxisId(number) = undefined
@@ -73,7 +201,7 @@ Index of [x axis](~xAxis) to combine with, which is useful
for multiple x axes i
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [x axis](~xAxis) to combine with, which is useful for multiple x axes in
one chart.
+The id of the [xAxis](~xAxis) to base on. When mutiple `xAxis` components
exist within an ECharts instance, use this to specify the corresponding `xAxis`.
## yAxisIndex(number) = 0
@@ -81,7 +209,7 @@ Id of [x axis](~xAxis) to combine with, which is useful for
multiple x axes in o
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [y axis](~yAxis) to combine with, which is useful for multiple y axes
in one chart.
+The index of the [yAxis](~yAxis) to base on. When mutiple `yAxis` components
exist within an ECharts instance, use this to specify the corresponding `yAxis`.
## yAxisId(number) = undefined
@@ -89,7 +217,7 @@ Index of [y axis](~yAxis) to combine with, which is useful
for multiple y axes i
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [y axis](~yAxis) to combine with, which is useful for multiple y axes in
one chart.
+The index of the [yAxis](~yAxis) to base on. When mutiple `yAxis` components
exist within an ECharts instance, use this to specify the corresponding `yAxis`.
{{ /if }}
{{ if: ${polar} }}
@@ -99,7 +227,7 @@ Id of [y axis](~yAxis) to combine with, which is useful for
multiple y axes in o
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [polar coordinate system](~polar) to combine with, which is useful
for multiple polar axes in one chart.
+The index of the [polar coordinate system](~polar) to base on. When mutiple
`polar` exist within an ECharts instance, use this to specify the corresponding
`polar`.
## polarId(number) = undefined
@@ -107,7 +235,7 @@ Index of [polar coordinate system](~polar) to combine with,
which is useful for
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [polar coordinate system](~polar) to combine with, which is useful for
multiple polar axes in one chart.
+The id of the [polar coordinate system](~polar) to base on. When mutiple
`polar` exist within an ECharts instance, use this to specify the corresponding
`polar`.
{{ /if }}
{{ if: ${singleAxis} }}
@@ -117,7 +245,7 @@ Id of [polar coordinate system](~polar) to combine with,
which is useful for mul
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [singleAxis coordinate system](~singleAxis) to combine with, which is
useful for multiple singleAxis in one chart.
+The index of the [singleAxis coordinate system](~singleAxis) to base on. When
mutiple `singleAxis` exist within an ECharts instance, use this to specify the
corresponding `singleAxis`.
## singleAxisId(number) = undefined
@@ -125,7 +253,7 @@ Index of [singleAxis coordinate system](~singleAxis) to
combine with, which is u
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [singleAxis coordinate system](~singleAxis) to combine with, which is
useful for multiple singleAxis in one chart.
+The id of the [singleAxis coordinate system](~singleAxis) to base on. When
mutiple `singleAxis` exist within an ECharts instance, use this to specify the
corresponding `singleAxis`.
{{ /if }}
{{ if: ${geo} }}
@@ -135,7 +263,7 @@ Id of [singleAxis coordinate system](~singleAxis) to
combine with, which is usef
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [geographic coordinate system](~geo) to combine with, which is useful
for multiple geographic axes in one chart.
+The index of the [geographic coordinate system](~geo) to base on. When mutiple
`geographic` exist within an ECharts instance, use this to specify the
corresponding `geographic`.
## geoId(number) = undefined
@@ -143,7 +271,7 @@ Index of [geographic coordinate system](~geo) to combine
with, which is useful f
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [geographic coordinate system](~geo) to combine with, which is useful
for multiple geographic axes in one chart.
+The id of the [geographic coordinate system](~geo) to base on. When mutiple
`geographic` exist within an ECharts instance, use this to specify the
corresponding `geographic`.
{{ /if }}
{{ if: ${parallel} }}
@@ -153,7 +281,7 @@ Id of [geographic coordinate system](~geo) to combine with,
which is useful for
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [parallel coordinate system](~parallel) to combine with, which is
useful for multiple parallel axes in one chart.
+The index of the [parallel coordinate system](~parallel) to base on. When
mutiple `parallel` exist within an ECharts instance, use this to specify the
corresponding `parallel`.
## parallelId(number) = undefined
@@ -161,7 +289,7 @@ Index of [parallel coordinate system](~parallel) to combine
with, which is usefu
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [parallel coordinate system](~parallel) to combine with, which is useful
for multiple parallel axes in one chart.
+The id of the [parallel coordinate system](~parallel) to base on. When mutiple
`parallel` exist within an ECharts instance, use this to specify the
corresponding `parallel`.
{{ /if }}
{{ if: ${calendar} }}
@@ -171,7 +299,7 @@ Id of [parallel coordinate system](~parallel) to combine
with, which is useful f
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [calendar coordinate system](~calendar) to combine with, which is
useful for multiple calendar coordinate system in one chart.
+The index of the [calendar coordinate system](~calendar) to base on. When
mutiple `calendar` exist within an ECharts instance, use this to specify the
corresponding `calendar`.
## calendarId(number) = undefined
@@ -179,7 +307,7 @@ Index of [calendar coordinate system](~calendar) to combine
with, which is usefu
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [calendar coordinate system](~calendar) to combine with, which is useful
for multiple calendar coordinate system in one chart.
+The id of the [calendar coordinate system](~calendar) to base on. When mutiple
`calendar` exist within an ECharts instance, use this to specify the
corresponding `calendar`.
{{ /if }}
{{ if: ${matrix} }}
@@ -189,7 +317,7 @@ Id of [calendar coordinate system](~calendar) to combine
with, which is useful f
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Index of [matrix coordinate system](~matrix) to combine with, which is useful
for multiple matrix coordinate system in one chart.
+The index of the [matrix coordinate system](~matrix) to base on. When mutiple
`matrix` exist within an ECharts instance, use this to specify the
corresponding `matrix`.
## matrixId(number) = undefined
@@ -197,6 +325,6 @@ Index of [matrix coordinate system](~matrix) to combine
with, which is useful fo
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-Id of [matrix coordinate system](~matrix) to combine with, which is useful for
multiple matrix coordinate system in one chart.
+The id of the [matrix coordinate system](~matrix) to base on. When mutiple
`matrix` exist within an ECharts instance, use this to specify the
corresponding `matrix`.
{{ /if }}
diff --git a/zh/option/partial/coord-sys.md b/zh/option/partial/coord-sys.md
index d64fd3ec..c6d18428 100644
--- a/zh/option/partial/coord-sys.md
+++ b/zh/option/partial/coord-sys.md
@@ -1,62 +1,193 @@
{{ target: partial-coord-sys }}
+{{ if: ${seriesType} }}
+{{ var: componentNameInLink = 'series-' + ${seriesType} }}
+{{ elif: ${nonSeriesComponentSubType} }}
+{{ var: componentNameInLink = ${nonSeriesComponentMainType} + '-' +
${nonSeriesComponentSubType} }}
+{{ else }}
+{{ var: componentNameInLink = ${nonSeriesComponentMainType} }}
+{{ /if }}
+
+{{ if: ${coordSysUsageSupportData} == null }}
+{{ if: ${seriesType} }}
+{{ var: coordSysUsageSupportData = true }}
+{{ /if }}
+{{ /if }}
+
+{{ if: ${coordSysUsageSupportBox} == null }}
+{{ if: ${nonSeriesComponentMainType} }}
+{{ var: coordSysUsageSupportBox = true }}
+{{ /if }}
+{{ /if }}
+
+{{ if: ${coordSysUsageDefault} == null }}
+{{ if: ${coordSysUsageSupportData} }}
+{{ var: coordSysUsageDefault = "'data'" }}
+{{ else }}
+{{ var: coordSysUsageDefault = "'box'" }}
+{{ /if }}
+{{ /if }}
+
+
## coordinateSystem(string) = ${coordSysDefault}
{{ if: ${version} }}
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-该系列或组件使用的坐标系，可选：
+指定另一个坐标系组件，本 `${componentNameInLink}` 布局在那个坐标系中。
+
+可选值：
{{ if: ${none} }}
+ `null`、`undefined` 或者 `'none'`
- 不使用坐标系。
+ 不布局在任何坐标系中。自己独立完成布局。
{{ /if }}
{{ if: ${cartesian2d} }}
+ `'cartesian2d'`
- 使用二维 [直角坐标系（也称笛卡尔坐标系）](~grid)，通过
[xAxisIndex](~series-${seriesType}.xAxisIndex) 和
[yAxisIndex](~series-${seriesType}.yAxisIndex) 或者
[xAxisId](~series-${seriesType}.xAxisId) 和
[yAxisId](~series-${seriesType}.yAxisId) 指定相应的坐标轴组件。
+ 布局在一个二维 [直角坐标系（也称笛卡尔坐标系）](~grid) 中。当一个 ECharts 实例中存在多个 x 坐标轴（`xAxis`）时或者多个
y 坐标轴（`yAxis`）时，须通过 [xAxisIndex](~${componentNameInLink}.xAxisIndex) 和
[yAxisIndex](~${componentNameInLink}.yAxisIndex) 或者
[xAxisId](~${componentNameInLink}.xAxisId) 和
[yAxisId](~${componentNameInLink}.yAxisId) 指定所使用的坐标轴。
+
+ 注：一些常用的系列，例如 [折线图（series-line）](~series-line),
[柱状图（series-bar）](~series-bar) 等，不能直接布局于 [矩阵坐标系（matrix）](~matrix) 或者
[日历坐标系（calendar）](~calendar) 中，但是他们能布局在 [直角坐标系（grid）](~grid) 中，然后这个
[直角坐标系（grid）](~grid) 可以布局在 [矩阵坐标系（matrix）](~matrix) 或
[日历坐标系（calendar）](~calendar) 中。
{{ /if }}
{{ if: ${polar} }}
+ `'polar'`
- 使用 [极坐标系](~polar)，通过 [polarIndex](~series-${seriesType}.polarIndex) 或
[polarId](~series-${seriesType}.polarId) 指定相应的极坐标系组件
+ 布局在一个 [极坐标系](~polar) 中。当一个 ECharts 实例中存在多个极坐标系时，须通过
[polarIndex](~${componentNameInLink}.polarIndex) 或
[polarId](~${componentNameInLink}.polarId) 指定所使用的极坐标系。
{{ /if }}
-{{ if: ${singleAxis} }}
-+ `'singleAxis'`
+{{ if: ${geo} }}
++ `'geo'`
+
+ 布局在一个 [地理坐标系](~geo) 中。当一个 ECharts 实例中存在多个地理坐标系时，须通过
[geoIndex](~${componentNameInLink}.geoIndex) 或
[geoId](~${componentNameInLink}.geoId) 指定所使用的地理坐标系。{{ if: ${seriesType} ===
'pie' }}
- 使用 [单轴坐标系](~singleAxis)，通过
[singleAxisIndex](~series-${seriesType}.singleAxisIndex) 或
[singleAxisId](~series-${seriesType}.singleAxisId) 指定相应的单轴标系组件
+ 参见示例 [地理坐标系中的饼图](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)。{{
/if }}
{{ /if }}
-{{ if: ${geo} }}
-+ `'geo'`
+{{ if: ${singleAxis} }}
++ `'singleAxis'`
- 使用 [地理坐标系](~geo)，通过 [geoIndex](~series-${seriesType}.geoIndex) 或
[geoId](~series-${seriesType}.geoId) 指定相应的地理坐标系组件。
+ 布局在一个 [单轴坐标系](~singleAxis) 中。当一个 ECharts 实例中存在多个单轴坐标系时，须通过
[singleAxisIndex](~${componentNameInLink}.singleAxisIndex) 或
[singleAxisId](~${componentNameInLink}.singleAxisId) 指定所使用的单轴标系。
{{ /if }}
{{ if: ${parallel} }}
+ `'parallel'`
- 使用 [平行坐标系](~parallel)，通过
[parallelIndex](~series-${seriesType}.parallelIndex) 或
[parallelId](~series-${seriesType}.parallelId) 指定相应的平行坐标系组件。
+ 布局在一个 [平行坐标系](~parallel) 中。当一个 ECharts 实例中存在多个平行坐标系时，须通过
[parallelIndex](~${componentNameInLink}.parallelIndex) 或
[parallelId](~${componentNameInLink}.parallelId) 指定所使用的平行坐标系。
{{ /if }}
{{ if: ${calendar} }}
+ `'calendar'`
- 使用 [日历坐标系](~calendar)，通过
[calendarIndex](~series-${seriesType}.calendarIndex) 或
[calendarId](~series-${seriesType}.calendarId) 指定相应的日历坐标系组件。
+ 布局在一个 [日历坐标系](~calendar) 中。当一个 ECharts 实例中存在多个日历坐标系时，须通过
[calendarIndex](~${componentNameInLink}.calendarIndex) 或
[calendarId](~${componentNameInLink}.calendarId) 指定所使用的日历坐标系。
{{ /if }}
{{ if: ${matrix} }}
+ `'matrix'`
- 使用 [矩阵坐标系](~matrix)，通过 [matrixIndex](~series-${seriesType}.matrixIndex) 或
[matrixId](~series-${seriesType}.matrixId) 指定相应的矩阵坐标系组件。
+ 布局在一个 [矩阵坐标系](~matrix)中。当一个 ECharts 实例中存在多个矩阵坐标系时，须通过
[matrixIndex](~${componentNameInLink}.matrixIndex) 或
[matrixId](~${componentNameInLink}.matrixId) 指定所使用的矩阵坐标系。{{if:
${nonSeriesComponentMainType} === 'grid' }}
+
+ 参见示例
[矩阵坐标系中直角坐标系](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1)。
+ {{ /if }}
+{{ /if }}
+
+
+**下表总结了“某系列或组件是否支持布局在某坐标系上”：**
+
+最左列列出了要布局的系列和组件（坐标系本身也是组件），最上行列出了所基于的坐标系。
+
+| | no coord sys | [grid](~grid) (cartesian2d) |
[polar](~polar) | [geo](~geo) | [singleAxis](~singleAxis) | [radar](~radar) |
[parallel](~parallel) | [calendar](~calendar) | [matrix](~matrix) |
+|------------------------------------------------|----------|----------|---------|----------|----------|----------|----------|
+| [grid](~grid) (cartesian2d) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [polar](~polar) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [geo](~geo) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [singleAxis](~singleAxis) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [calendar](~calendar) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [matrix](~matrix) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-line](~series-line) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) | ❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) |
+| [series-bar](~series-bar) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) | ❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) |
+| [series-pie](~series-pie) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-scatter](~series-scatter) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-effectScatter](~series-effectScatter) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [series-radar](~series-radar) | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
❌ (✅ 如果通过 [radar](~radar) 坐标系) | ❌ (✅ 如果通过 [radar](~radar) 坐标系) |
+| [series-tree](~series-tree) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-treemap](~series-treemap) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-sunburst](~series-sunburst) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-boxplot](~series-boxplot) | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) | ❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) |
+| [series-candlestick](~series-candlestick) | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) | ❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) |
+| [series-heatmap](~series-heatmap) | ❌ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-map](~series-map) | ✅ (create a geo coord sys
exclusively) | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| [series-parallel](~series-parallel) | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
❌ (✅ 如果通过 [parallel](~parallel) 坐标系) | ❌ (✅ 如果通过 [parallel](~parallel) 坐标系) |
+| [series-lines](~series-lines) | ❌ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [geo](~geo)) | ❌ (✅ 如果通过其他坐标系，如 [geo](~geo)) |
+| [series-graph](~series-graph) | ✅ (create a "view" coord sys
exclusively) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ |
+| [series-sankey](~series-sankey) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌
| ✅ | ✅ |
+| [series-funnel](~series-funnel) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌
| ✅ | ✅ |
+| [series-gauge](~series-gauge) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [series-pictorialBar](~series-pictorialBar) | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) | ❌ (✅ 如果通过其他坐标系，如 [grid](~grid)) |
+| [series-themeRiver](~series-themeRiver) | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ |
❌ (✅ 如果通过其他坐标系，如 [singleAxis](~singleAxis)) | ❌ (✅ 如果通过其他坐标系，如
[singleAxis](~singleAxis)) |
+| [series-chord](~series-chord) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
✅ | ✅ |
+| [title](~title) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [legend](~legend) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [dataZoom](~dataZoom) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [visualMap](~visualMap) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [toolbox](~toolbox) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [timeline](~timeline) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+| [thumbnail](~thumbnail) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
✅ | ✅ |
+
+也参见
[${componentNameInLink}.coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage)。
+
+
+## coordinateSystemUsage(string) = ${coordSysUsageDefault}
+
+{{ use: partial-version(version = ${version|minVersion('6.0.0')}) }}
+
+如何在指定的 [坐标系](~${componentNameInLink}.coordinateSystem) 上布局本
`${componentNameInLink}`。
+
+在大多数情况下，无需显式指定 `coordinateSystemUsage`，除非默认行为不符合预期。
+
+可选值：
+- `'data'`：{{ if: !${coordSysUsageSupportData} }}**（不适用于
[${componentNameInLink}](~${componentNameInLink})）**{{ /if }}
+
+ 此系列的每个数据项（例如，每个 `series.data[i]`）将独立地在指定的坐标系进行布局。
+ 注：当前没有任何“非系列组件”支持 `coordinateSystemUsage: 'data'`。
+
+- `'box'`：{{ if: !${coordSysUsageSupportBox} }}**（不适用于
[${componentNameInLink}](~${componentNameInLink})）**{{ /if }}
+
+ 此系列或组件作为一个整体，在指定的坐标系中进行布局——即根据坐标系计算整体的包围盒或基础锚点。
+
+ - 例如，[grid 组件](~grid) 可以布局在 [matrix 坐标系](~matrix) 或 [calendar
坐标系](~calendar) 中，这时其布局矩形是由
[${componentNameInLink}.coords](~${componentNameInLink}.coords)
在坐标系中计算出来的。参见示例：[矩阵中的小型直角坐标系](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1)。
+ - 又如，[饼图系列](~series-pie) 或 [和弦图系列](~series-chord) 可以布局在 [geo 坐标系](~geo) 或
[cartesian2d 坐标系](~grid) 中，这时其中心点是由 [series-pie.coords](~series-pie.coords) 或
[series-pie.center](~series-pie.center)
在坐标系中计算出来的。参见示例：[地理坐标系中的饼图](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)。
+
+{{ if: ${seriesType} }}
+只有少数系列同时支持 `coordinateSystemUsage: 'data'` 和 `coordinateSystemUsage:
'box'`，如：[series-graph](~series-graph)、[series-map](~series-map)。例如，在 [例子
coordinateSystemUsage: 'data'](${galleryEditorPath}matrix-graph&edit=1&reset=1)
中，关系图每个节点分别布局在矩阵坐标系中，而在 [例子 coordinateSystemUsage:
'box'](${galleryEditorPath}doc-example/matrix-graph-box&edit=1&reset=1)
中，关系图系列整体被布局在一个单元格中。
+
+大多数系列仅支持 `coordinateSystemUsage:
'data'`，例如：[series-line](~series-line)、[series-bar](~series-bar)、[series-scatter](~series-scatter)。
+
+同时，一些系列仅支持 `coordinateSystemUsage:
'box'`，例如：[series-pie](~series-pie)（示例：[地理坐标系中的饼图](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)）、[series-tree](~series-tree)、[series-treemap](~series-treemap)、[series-sankey](~series-sankey)。
{{ /if }}
+另参考：[${componentNameInLink}.coordinateSystem](~${componentNameInLink}.coordinateSystem)。
+
+## coord(Array|string)
+
+{{ use: partial-version(version = ${version|minVersion('6.0.0')}) }}
+
+当 [coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage) 为
`'box'` 时, `coord` 被输入给坐标系，计算得到布局位置（布局盒或者中心点）。
+
+例子：[微型直角坐标系矩阵](${galleryEditorPath}matrix-cartesian-tiny&edit=1&reset=1),
[矩阵中的关系图](${galleryEditorPath}doc-example/matrix-graph-box&edit=1&reset=1).
+
+{{ if: ${seriesType} === 'pie' }}
+在此场景下，[series-pie.center](~series-pie.center) 和
[series-pie.coord](~series-pie.coord) 起同样作用。
+
+[例子：地理坐标系中的饼图](${galleryEditorPath}map-iceland-pie&edit=1&reset=1)
+{{ /if }}
+
+> 注：当 [coordinateSystemUsage](~${componentNameInLink}.coordinateSystemUsage) 为
`'data'` 时，输入给坐标系的是 `series.data[i]` 而非此 `coord`。
+
{{ if: ${cartesian2d} }}
## xAxisIndex(number) = 0
@@ -65,7 +196,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的 [x 轴](~xAxis)的 index，在单个图表实例中存在多个 x 轴的时候有用。
+布局时所基于的 [x 轴](~xAxis) 的 index。当一个 ECharts 实例中存在多个 x 轴时，用其指定所使用的 x 轴。
## xAxisId(number) = undefined
@@ -73,7 +204,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的 [x 轴](~xAxis)的 id，在单个图表实例中存在多个 x 轴的时候有用。
+布局时所基于的 [x 轴](~xAxis) 的 id。当一个 ECharts 实例中存在多个 x 轴时，用其指定所使用的 x 轴。
## yAxisIndex(number) = 0
@@ -81,7 +212,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的 [y 轴](~yAxis)的 index，在单个图表实例中存在多个 y轴的时候有用。
+布局时所基于的 [y 轴](~yAxis) 的 index。当一个 ECharts 实例中存在多个 y轴时，用其指定所使用的 y 轴。
## yAxisId(number) = undefined
@@ -89,7 +220,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的 [y 轴](~yAxis)的 id，在单个图表实例中存在多个 y轴的时候有用。
+布局时所基于的 [y 轴](~yAxis) 的 id。当一个 ECharts 实例中存在多个 y轴时，用其指定所使用的 x 轴。
{{ /if }}
{{ if: ${polar} }}
@@ -99,7 +230,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[极坐标系](~polar)的 index，在单个图表实例中存在多个极坐标系的时候有用。
+布局时所基于的 [极坐标系](~polar) 的 index。当一个 ECharts 实例中存在多个极坐标系时，用其指定所使用的坐标系。
## polarId(number) = undefined
@@ -107,7 +238,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[极坐标系](~polar)的 id，在单个图表实例中存在多个极坐标系的时候有用。
+布局时所基于的 [极坐标系](~polar) 的 id。当一个 ECharts 实例中存在多个极坐标系时，用其指定所使用的坐标系。
{{ /if }}
{{ if: ${singleAxis} }}
@@ -117,7 +248,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[单轴标系](~singleAxis)的 index，在单个图表实例中存在多个单轴坐标系的时候有用。
+布局时所基于的 [单轴标系](~singleAxis) 的 index。当一个 ECharts 实例中存在多个单轴坐标系时，用其指定所使用的坐标系。
## singleAxisId(number) = undefined
@@ -125,7 +256,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[单轴标系](~singleAxis)的 id，在单个图表实例中存在多个单轴坐标系的时候有用。
+布局时所基于的 [单轴标系](~singleAxis) 的 id。当一个 ECharts 实例中存在多个单轴坐标系时，用其指定所使用的坐标系。
{{ /if }}
{{ if: ${geo} }}
@@ -135,7 +266,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[地理坐标系](~geo)的 index，在单个图表实例中存在多个地理坐标系的时候有用。
+布局时所基于的 [地理坐标系](~geo) 的 index。当一个 ECharts 实例中存在多个地理坐标系时，用其指定所使用的坐标系。
## geoId(number) = undefined
@@ -143,7 +274,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[地理坐标系](~geo)的 id，在单个图表实例中存在多个地理坐标系的时候有用。
+布局时所基于的 [地理坐标系](~geo) 的 id。当一个 ECharts 实例中存在多个地理坐标系时，用其指定所使用的坐标系。
{{ /if }}
{{ if: ${parallel} }}
@@ -153,7 +284,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[平行坐标系](~parallel)的 index，在单个图表实例中存在多个平行坐标系的时候有用。
+布局时所基于的 [平行坐标系](~parallel) 的 index。当一个 ECharts 实例中存在多个平行坐标系时，用其指定所使用的坐标系。
## parallelId(number) = undefined
@@ -161,7 +292,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[平行坐标系](~parallel)的 id，在单个图表实例中存在多个平行坐标系的时候有用。
+布局时所基于的 [平行坐标系](~parallel) 的 id。当一个 ECharts 实例中存在多个平行坐标系时，用其指定所使用的坐标系。
{{ /if }}
{{ if: ${calendar} }}
@@ -171,7 +302,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[日历坐标系](~calendar)的 index，在单个图表实例中存在多个日历坐标系的时候有用。
+布局时所基于的 [日历坐标系](~calendar) 的 index。当一个 ECharts 实例中存在多个日历坐标系时，用其指定所使用的坐标系。
## calendarId(number) = undefined
@@ -179,7 +310,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[日历坐标系](~calendar)的 id，在单个图表实例中存在多个日历坐标系的时候有用。
+布局时所基于的 [日历坐标系](~calendar) 的 id。当一个 ECharts 实例中存在多个日历坐标系时，用其指定所使用的坐标系。
{{ /if }}
{{ if: ${matrix} }}
@@ -189,7 +320,7 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[矩阵坐标系](~matrix)的 index，在单个图表实例中存在多个矩阵坐标系的时候有用。
+布局时所基于的 [矩阵坐标系](~matrix) 的 index。当一个 ECharts 实例中存在多个矩阵坐标系时，用其指定所使用的坐标系。
## matrixId(number) = undefined
@@ -197,6 +328,6 @@
{{ use: partial-version(version = ${version}) }}
{{ /if }}
-使用的[矩阵坐标系](~matrix)的 id，在单个图表实例中存在多个矩阵坐标系的时候有用。
+布局时所基于的 [矩阵坐标系](~matrix) 的 id。当一个 ECharts 实例中存在多个矩阵坐标系时，用其指定所使用的坐标系。
{{ /if }}
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@echarts.apache.org
For additional commands, e-mail: commits-h...@echarts.apache.org
