This is an automated email from the ASF dual-hosted git repository.
plainheart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/echarts-doc.git
The following commit(s) were added to refs/heads/master by this push:
new 98a8eae0 refine toolbox doc
98a8eae0 is described below
commit 98a8eae00964eb1bdf5d90eb7b5ce2f7afb7e003
Author: plainheart <[email protected]>
AuthorDate: Thu Jun 11 17:44:32 2026 +0800
refine toolbox doc
---
en/option/component/toolbox.md | 25 +++++++++++++++++++++++++
en/option/partial/component-common-style.md | 8 ++++----
en/option/partial/padding.md | 12 ++++++------
zh/option/component/toolbox.md | 25 +++++++++++++++++++++++++
zh/option/partial/component-common-style.md | 9 +++++----
zh/option/partial/padding.md | 8 ++++----
6 files changed, 69 insertions(+), 18 deletions(-)
diff --git a/en/option/component/toolbox.md b/en/option/component/toolbox.md
index 9c5d6718..c83baf4f 100644
--- a/en/option/component/toolbox.md
+++ b/en/option/component/toolbox.md
@@ -106,6 +106,31 @@ Whether to show toolbox component.
Background color of toolbox component.
+## padding(number|Array) = 15
+
+{{ use: partial-padding(
+ componentName = "toolbox",
+ defaultPadding: 15
+) }}
+
+<ExampleUIControlVector dims="T,R,B,L" default="15,15,15,15" min="0"
step="0.5" />
+
+## borderColor(Color) = '#b7b9be'
+
+<ExampleUIControlColor default="#b7b9be" />
+
+The border color of the toolbox component.
+
+## borderWidth(number) = 0
+
+<ExampleUIControlNumber default="0" min="0" step="0.5" />
+
+The border width in pixel (`px`) of the toolbox component.
+
+{{ use: partial-border-radius(
+ prefix = "#"
+) }}
+
## orient(string) = 'horizontal'
<ExampleUIControlEnum options="vertical,horizontal" />
diff --git a/en/option/partial/component-common-style.md
b/en/option/partial/component-common-style.md
index 26df12c2..04df0a10 100644
--- a/en/option/partial/component-common-style.md
+++ b/en/option/partial/component-common-style.md
@@ -58,11 +58,11 @@ Border width of ${componentName}.
<ExampleUIControlVector min="0" dims="LT,RT,RB,LB" />
-The radius of rounded corner. Its unit is px. And it supports use array to
respectively specify the 4 corner radiuses.
+The radius of the rounded corners, specified in pixels (px). Supports an array
to define each of the four corners individually.
For example:
-```
-${propName|default('borderRadius')}: 5, // consistently set the size of 4
rounded corners
-${propName|default('borderRadius')}: [5, 5, 0, 0] // (clockwise upper left,
upper right, bottom right and bottom left)
+```ts
+${propName|default('borderRadius')}: 5, // Applies to all four corners
+${propName|default('borderRadius')}: [5, 5, 0, 0] // Clockwise from top-left:
[top-left, top-right, bottom-right, bottom-left]
```
diff --git a/en/option/partial/padding.md b/en/option/partial/padding.md
index 9fcb3873..1cdd33ca 100644
--- a/en/option/partial/padding.md
+++ b/en/option/partial/padding.md
@@ -3,19 +3,19 @@
<ExampleUIControlVector min="0" dims="T,R,B,L" />
-${componentName} space around content. The unit is px. Default values for each
position are 5. And they can be set to different values with left, right, top,
and bottom.
+The spacing around the ${componentName} content, specified in pixels (`px`).
The default value for each side is `${defaultPadding|default(5)}`. Supports a
single value, a 2-value array, or a 4-value array to configure each side.
Examples:
```ts
-// Set padding to be 5
+// Applies to all four sides
padding: 5
-// Set the top and bottom paddings to be 5, and left and right paddings to be
10
+// [vertical, horizontal] -> top/bottom: 5, left/right: 10
padding: [5, 10]
-// Set each of the four paddings separately
+// Clockwise order: [top, right, bottom, left]
padding: [
- 5, // up
+ 5, // top
10, // right
- 5, // down
+ 5, // bottom
10, // left
]
```
diff --git a/zh/option/component/toolbox.md b/zh/option/component/toolbox.md
index 8d72794f..4170bdff 100644
--- a/zh/option/component/toolbox.md
+++ b/zh/option/component/toolbox.md
@@ -180,6 +180,31 @@ option = {
工具栏组件的背景色。
+## padding(number|Array) = 15
+
+{{ use: partial-padding(
+ componentName = "toolbox",
+ defaultPadding: 15
+) }}
+
+<ExampleUIControlVector dims="T,R,B,L" default="15,15,15,15" min="0"
step="0.5" />
+
+## borderColor(Color) = '#b7b9be'
+
+<ExampleUIControlColor default="#b7b9be" />
+
+工具栏组件的边框颜色。
+
+## borderWidth(number) = 0
+
+<ExampleUIControlNumber default="0" min="0" step="0.5" />
+
+工具栏组件的边框线宽,单位为像素 (`px`)。
+
+{{ use: partial-border-radius(
+ prefix = "#"
+) }}
+
## orient(string) = 'horizontal'
<ExampleUIControlEnum options="vertical,horizontal" />
diff --git a/zh/option/partial/component-common-style.md
b/zh/option/partial/component-common-style.md
index bd19a889..8c682ec4 100644
--- a/zh/option/partial/component-common-style.md
+++ b/zh/option/partial/component-common-style.md
@@ -58,10 +58,11 @@ ${componentName}的边框线宽。
<ExampleUIControlVector min="0" dims="LT,RT,RB,LB" />
-圆角半径,单位px,支持传入数组分别指定 4 个圆角半径。
-如:
-```
+圆角半径,单位为像素 (px)。支持传入单个数值或数组。传入数组时,可按顺时针方向分别指定四个角的半径。
+
+例如:
+```ts
${propName|default('borderRadius')}: 5, // 统一设置四个角的圆角大小
-${propName|default('borderRadius')}: [5, 5, 0, 0] //(顺时针左上,右上,右下,左下)
+${propName|default('borderRadius')}: [5, 5, 0, 0] // 顺时针方向:[左上, 右上, 右下, 左下]
```
diff --git a/zh/option/partial/padding.md b/zh/option/partial/padding.md
index 72fc1759..2fdc9d28 100644
--- a/zh/option/partial/padding.md
+++ b/zh/option/partial/padding.md
@@ -3,15 +3,15 @@
<ExampleUIControlVector min="0" dims="T,R,B,L" />
-${componentName}内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距。
+${componentName}的内边距(内容周围的留白区域),单位为像素 (`px`)。每个方向的默认值为
`${defaultPadding|default(5)}`。支持传入单个数值、双值数组或四值数组来灵活配置。
使用示例:
```ts
-// 设置内边距为 5
+// 同时应用于上下左右四个方向
padding: 5
-// 设置上下的内边距为 5,左右的内边距为 10
+// [上下, 左右] -> 上下内边距为 5,左右内边距为 10
padding: [5, 10]
-// 分别设置四个方向的内边距
+// 顺时针方向:[上, 右, 下, 左]
padding: [
5, // 上
10, // 右
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]