refine doc for stack and extract stack doc part (fix #493)

plainheart · plainheart · commit 8f1ccf49e4dd · 2026-03-06T15:42:16.000+08:00
diff --git a/en/option-gl/partial/stack.md b/en/option-gl/partial/stack.md
@@ -0,0 +1,44 @@
+
+{{ target: partial-stack }}
+
+## stack(string)
+
+Name of the stack group. Series with the same `stack` name on the **same category axis** will be stacked on top of each other. See [stackStrategy](~series-${componentNameInLink}.stackStrategy) for customizing how values are stacked.
+
+**Notice:** Stacking **only supports the stacked axis being of type** `'value'` or `'log'`. Axes of type `'time'` and `'category'` are **not supported** as the stacked axis.
+
+{{ if: ${componentNameInLink} === 'line' }}
+You can view the effect of the example below by switching stacks in the [toolbox](~toolbox) in the top-right corner.
+
+~[600x400](${galleryViewPath}doc-example/line-stack-tiled&edit=1&reset=1)
+{{ /if }}
+
+## stackStrategy(string) = 'samesign'
+
+{{ use: partial-version(
+    isECharts = true,
+    version = '5.3.3'
+) }}
+
+Strategy for stacking values, only effective when [stack](~series-${componentNameInLink}.stack) is set. Optional values:
+
++ `'samesign'` Only stack values if the value to be stacked has the **same sign** as the currently cumulated stacked value. **(Default)**
++ `'all'`      Stack all values regardless of positive or negative.
++ `'positive'` Only stack positive values.
++ `'negative'` Only stack negative values.
+
+## stackOrder(string) = 'seriesAsc'
+
+{{ use: partial-version(
+    isECharts = true,
+    version = '6.0.0'
+) }}
+
+Stack order. Optional values:
+
++ `'seriesAsc'`  Stack in series order. **(Default)**
++ `'seriesDesc'` Stack in reversed series order.
+
+**Notice:** 
+
++ `stackOrder` should be defined for all series with the same `stack` name. If `stackOrder` is defined for only some of the series, the stack order may change unexpectedly when certain series are hidden (e.g., through legend toggle).
diff --git a/en/option-gl/series/bar3D.md b/en/option-gl/series/bar3D.md
@@ -36,27 +36,10 @@ Below are the differences between beveling and no beveling.
 
 The smoothness of the bevel, the larger the value, the smoother.
 
-## stack(string)
-
-Stacking of bar chart. On the same category axis, the series with the same `stack` name would be put on top of each other. Note that the data items that need to be stack in different series must have the same index in the array.
-
-See also [stackStrategy](~series-bar3D.stackStrategy) on how to customize how values are stacked.
-
-Notice: `stack` only supports stacking on `value` and `log` axis for now. `time` and `category` axis are not supported.
-
-## stackStrategy(string) = 'samesign'
-
-{{ use: partial-version(
-    isECharts = true,
-    version = '5.3.3'
+{{ use: partial-stack(
+    componentNameInLink = 'bar3D'
 ) }}
 
-How to stack values if the [stack](~series-bar3D.stack) property has been set. Options:
-+ `'samesign'`: only stack values if the value to be stacked has the same sign as the currently cumulated stacked value.
-+ `'all'`: stack all values, irrespective of the signs of the current or cumulative stacked value.
-+ `'positive'`: only stack positive values.
-+ `'negative'`: only stack negative values.
-
 ## minHeight(number) = 0
 
 The minimum width of the bar.
diff --git a/en/option/partial/stack.md b/en/option/partial/stack.md
@@ -0,0 +1,44 @@
+
+{{ target: partial-stack }}
+
+## stack(string)
+
+Name of the stack group. Series with the same `stack` name on the **same category axis** will be stacked on top of each other. See [stackStrategy](~series-${componentNameInLink}.stackStrategy) for customizing how values are stacked.
+
+**Notice:** Stacking **only supports the stacked axis being of type** `'value'` or `'log'`. Axes of type `'time'` and `'category'` are **not supported** as the stacked axis.
+
+{{ if: ${componentNameInLink} === 'line' }}
+You can view the effect of the example below by switching stacks in the [toolbox](~toolbox) in the top-right corner.
+
+~[600x400](${galleryViewPath}doc-example/line-stack-tiled&edit=1&reset=1)
+{{ /if }}
+
+## stackStrategy(string) = 'samesign'
+
+{{ use: partial-version(
+    version = '5.3.3'
+) }}
+
+Strategy for stacking values, only effective when [stack](~series-${componentNameInLink}.stack) is set. Optional values:
+
++ `'samesign'` Only stack values if the value to be stacked has the **same sign** as the currently cumulated stacked value. **(Default)**
++ `'all'`      Stack all values regardless of positive or negative.
++ `'positive'` Only stack positive values.
++ `'negative'` Only stack negative values.
+
+## stackOrder(string) = 'seriesAsc'
+
+{{ use: partial-version(
+    version = '6.0.0'
+) }}
+
+Stack order. Optional values:
+
++ `'seriesAsc'`  Stack in series order. **(Default)**
++ `'seriesDesc'` Stack in reversed series order.
+
+**Notice:** 
+
++ `stackOrder` should be defined for all series with the same `stack` name. If `stackOrder` is defined for only some of the series, the stack order may change unexpectedly when certain series are hidden (e.g., through legend toggle).
+
++ Not supported in `polar` coordinate system.
diff --git a/en/option/series/bar.md b/en/option/series/bar.md
@@ -135,41 +135,10 @@ Configurations of select state. Available when [selectedMode](~series-bar.select
     version = '5.0.0'
 ) }}
 
-## stack(string) = null
-
-Name of stack. On the same category axis, the series with the same `stack` name would be put on top of each other.
-
-See also [stackStrategy](~series-bar.stackStrategy) on how to customize how values are stacked.
-
-Notice: `stack` only supports stacking on `value` and `log` axis for now. `time` and `category` axis are not supported.
-
-## stackStrategy(string) = 'samesign'
-
-{{ use: partial-version(
-    version = '5.3.3'
+{{ use: partial-stack(
+    componentNameInLink = 'bar'
 ) }}
 
-How to stack values if the [stack](~series-bar.stack) property has been set. Options:
-
-+ `'samesign'`: only stack values if the value to be stacked has the same sign as the currently cumulated stacked value.
-+ `'all'`: stack all values, irrespective of the signs of the current or cumulative stacked value.
-+ `'positive'`: only stack positive values.
-+ `'negative'`: only stack negative values.
-
-## stackOrder(string) = 'seriesAsc'
-
-{{ use: partial-version(
-    version = '6.0.0'
-) }}
-
-Stack order. Optional values:
-+ `'seriesAsc'` (default, stack in series order)
-+ `'seriesDesc'` (reverse stack order)
-
-**Note:** `stackOrder` should be defined for all series with the same `stack` name. If `stackOrder` is defined for only some of the series, the stack order may change unexpectedly when certain series are hidden (e.g., through legend toggle).
-
-Not supported in polar coordinate system.
-
 ## sampling(string)
 
 The downsampling strategy used when the data size is much larger than pixel size. It will improve the performance when turned on. Defaults to be turned off, indicating that all the data points will be drawn.
diff --git a/en/option/series/line.md b/en/option/series/line.md
@@ -57,45 +57,10 @@ Only work when main axis is `'category'` axis (`axis.type` is `'category'`). Opt
 
 {{ use: partial-legend-hover-link() }}
 
-## stack(string) = null
-
-If stack the value. On the same category axis, the series with the same `stack` name would be put on top of each other.
-
-See also [stackStrategy](~series-line.stackStrategy) on how to customize how values are stacked.
-
-Notice: `stack` only supports stacking on `value` and `log` axis for now. `time` and `category` axis are not supported.
-
-The effect of the below example could be seen through stack switching of [toolbox](~toolbox) on the top right corner:
-
-~[600x400](${galleryViewPath}doc-example/line-stack-tiled&edit=1&reset=1)
-
-## stackStrategy(string) = 'samesign'
-
-{{ use: partial-version(
-    version = '5.3.3'
+{{ use: partial-stack(
+    componentNameInLink = 'line'
 ) }}
 
-How to stack values if the [stack](~series-line.stack) property has been set. Options:
-
-+ `'samesign'`: only stack values if the value to be stacked has the same sign as the currently cumulated stacked value.
-+ `'all'`: stack all values, irrespective of the signs of the current or cumulative stacked value.
-+ `'positive'`: only stack positive values.
-+ `'negative'`: only stack negative values.
-
-## stackOrder(string) = 'seriesAsc'
-
-{{ use: partial-version(
-    version = '6.0.0'
-) }}
-
-Stack order. Optional values:
-+ `'seriesAsc'` (default, stack in series order)
-+ `'seriesDesc'` (reverse stack order)
-
-**Note:** `stackOrder` should be defined for all series with the same `stack` name. If `stackOrder` is defined for only some of the series, the stack order may change unexpectedly when certain series are hidden (e.g., through legend toggle).
-
-Not supported in polar coordinate system.
-
 {{ use: partial-cursor() }}
 
 ## connectNulls(boolean) = false
diff --git a/zh/option-gl/partial/stack.md b/zh/option-gl/partial/stack.md
@@ -0,0 +1,44 @@
+
+{{ target: partial-stack }}
+
+## stack(string)
+
+堆叠的组名。在**同一个类目轴（category axis）**上，配置了相同 `stack` 组名的系列会互相堆叠。关于数值的堆叠方式，可参见 [stackStrategy](~series-${componentNameInLink}.stackStrategy)。
+
+**注意：**堆叠功能只支持被堆叠轴为 `'value'` 或 `'log'` 类型，不支持被堆叠轴为 `'time'` 或 `'category'` 类型。
+
+{{ if: ${componentNameInLink} === 'line' }}
+下面示例可以通过右上角 [toolbox](~toolbox) 中的堆叠切换看效果：
+
+~[600x400](${galleryViewPath}doc-example/line-stack-tiled&edit=1&reset=1)
+{{ /if }}
+
+## stackStrategy(string) = 'samesign'
+
+{{ use: partial-version(
+    isECharts = true,
+    version = '5.3.3'
+) }}
+
+堆叠数值的计算方式，仅在设置了 [stack](~series-${componentNameInLink}.stack) 属性后生效。可选值：
+
++ `'samesign'` 仅当待堆叠数值与当前累积堆叠值正负符号一致时才堆叠。**(默认)**
++ `'all'`      堆叠所有数值，不区分正负。
++ `'positive'` 只堆叠正值。
++ `'negative'` 只堆叠负值。
+
+## stackOrder(string) = 'seriesAsc'
+
+{{ use: partial-version(
+    isECharts = true,
+    version = '6.0.0'
+) }}
+
+堆叠顺序。可选值：
+
++ `'seriesAsc'`  按系列顺序堆叠。**(默认)**
++ `'seriesDesc'` 按系列反向顺序堆叠。
+
+**注意：** 
+
++ `stackOrder` 应该为所有具有相同 `stack` 名称的系列定义。如果只为部分系列定义 `stackOrder`，当某些系列被隐藏（如通过图例切换）时，可能会导致堆叠顺序发生意外变化。
diff --git a/zh/option-gl/series/bar3D.md b/zh/option-gl/series/bar3D.md
@@ -34,26 +34,10 @@
 
 柱子倒角的光滑/圆润度，数值越大越光滑/圆润。
 
-## stack(string)
-
-柱状图堆叠，相同 `stack` 值的柱状图系列数据会有叠加。注意不同系列需要叠加的数据项在数组中的索引必须是一样的。关于如何定制数值的堆叠方式，参见 [stackStrategy](~series-bar3D.stackStrategy)。
-
-注：目前 `stack` 只支持堆叠于 `value` 和 `log` 类型的类目轴上，不支持 `time` 和 `category` 类型的类目轴。
-
-## stackStrategy(string) = 'samesign'
-
-{{ use: partial-version(
-    isECharts = true,
-    version = '5.3.3'
+{{ use: partial-stack(
+    componentNameInLink = 'bar3D'
 ) }}
 
-堆积数值的策略，前提是[stack](~series-bar3D.stack)属性已被设置。其值可以是：
-
-+ `'samesign'` 只在要堆叠的值与当前累积的堆叠值具有相同的正负符号时才堆叠。
-+ `'all'` 堆叠所有的值，不管当前或累积的堆叠值的正负符号是什么。
-+ `'positive'` 只堆积正值。
-+ `'negative'` 只堆叠负值。
-
 ## minHeight(number) = 0
 
 最小柱子高度。
diff --git a/zh/option/partial/stack.md b/zh/option/partial/stack.md
@@ -0,0 +1,44 @@
+
+{{ target: partial-stack }}
+
+## stack(string)
+
+堆叠的组名。在**同一个类目轴（category axis）**上，配置了相同 `stack` 组名的系列会互相堆叠。关于数值的堆叠方式，可参见 [stackStrategy](~series-${componentNameInLink}.stackStrategy)。
+
+**注意：**堆叠功能只支持被堆叠轴为 `'value'` 或 `'log'` 类型，不支持被堆叠轴为 `'time'` 或 `'category'` 类型。
+
+{{ if: ${componentNameInLink} === 'line' }}
+下面示例可以通过右上角 [toolbox](~toolbox) 中的堆叠切换看效果：
+
+~[600x400](${galleryViewPath}doc-example/line-stack-tiled&edit=1&reset=1)
+{{ /if }}
+
+## stackStrategy(string) = 'samesign'
+
+{{ use: partial-version(
+    version = '5.3.3'
+) }}
+
+堆叠数值的计算方式，仅在设置了 [stack](~series-${componentNameInLink}.stack) 属性后生效。可选值：
+
++ `'samesign'` 仅当待堆叠数值与当前累积堆叠值正负符号一致时才堆叠。**(默认)**
++ `'all'`      堆叠所有数值，不区分正负。
++ `'positive'` 只堆叠正值。
++ `'negative'` 只堆叠负值。
+
+## stackOrder(string) = 'seriesAsc'
+
+{{ use: partial-version(
+    version = '6.0.0'
+) }}
+
+堆叠顺序。可选值：
+
++ `'seriesAsc'`  按系列顺序堆叠。**(默认)**
++ `'seriesDesc'` 按系列反向顺序堆叠。
+
+**注意：** 
+
++ `stackOrder` 应该为所有具有相同 `stack` 名称的系列定义。如果只为部分系列定义 `stackOrder`，当某些系列被隐藏（如通过图例切换）时，可能会导致堆叠顺序发生意外变化。
+
++ 当前不支持极坐标系。
diff --git a/zh/option/series/bar.md b/zh/option/series/bar.md
@@ -214,39 +214,10 @@ option = {
     version = '5.0.0'
 ) }}
 
-## stack(string) = null
-
-数据堆叠，同个类目轴上系列配置相同的 `stack` 值可以堆叠放置。关于如何定制数值的堆叠方式，参见 [stackStrategy](~series-bar.stackStrategy)。
-
-注：目前 `stack` 只支持堆叠于 `'value'` 和 `'log'` 类型的类目轴上，不支持 `'time'` 和 `'category'` 类型的类目轴。
-
-## stackStrategy(string) = 'samesign'
-
-{{ use: partial-version(
-    version = '5.3.3'
-) }}
-
-堆积数值的策略，前提是[stack](~series-bar.stack)属性已被设置。其值可以是：
-
-+ `'samesign'` 只在要堆叠的值与当前累积的堆叠值具有相同的正负符号时才堆叠。
-+ `'all'` 堆叠所有的值，不管当前或累积的堆叠值的正负符号是什么。
-+ `'positive'` 只堆积正值。
-+ `'negative'` 只堆叠负值。
-
-## stackOrder(string) = 'seriesAsc'
-
-{{ use: partial-version(
-    version = '6.0.0'
+{{ use: partial-stack(
+    componentNameInLink = 'bar'
 ) }}
 
-堆叠顺序。可选值：
-+ `'seriesAsc'`（默认，系列顺序堆叠）
-+ `'seriesDesc'`（反向堆叠）
-
-**注意：** `stackOrder` 应该为所有具有相同 `stack` 名称的系列定义。如果只为部分系列定义 `stackOrder`，当某些系列被隐藏（如通过图例切换）时，可能会导致堆叠顺序发生意外变化。
-
-当前不支持极坐标系。
-
 ## sampling(string)
 
 柱状图在数据量远大于像素点时候的降采样策略，开启后可以有效的优化图表的绘制效率，默认关闭，也就是全部绘制不过滤数据点。
diff --git a/zh/option/series/line.md b/zh/option/series/line.md
