3.0

2026-05-22 17:00:08 +00:00 · 2022-05-22 22:17:38 +08:00
parent 003f4da9de
commit bafe032bb9
391 changed files with 3718 additions and 2774 deletions
--- a/Documentation/XChartsConfiguration-ZH.md
+++ b/Documentation/XChartsConfiguration-ZH.md
@@ -47,6 +47,7 @@
 - [Axis](#Axis)
 - [Background](#Background)
 - [CalendarCoord](#CalendarCoord)
+- [Comment](#Comment)
 - [CoordSystem](#CoordSystem)
 - [DataZoom](#DataZoom)
 - [GridCoord](#GridCoord)
@@ -82,9 +83,14 @@
 - [AxisTick](#AxisTick)
 - [BaseAxisTheme](#BaseAxisTheme)
 - [BaseLine](#BaseLine)
+- [CommentItem](#CommentItem)
+- [CommentMarkStyle](#CommentMarkStyle)
 - [ComponentTheme](#ComponentTheme)
 - [DataZoomTheme](#DataZoomTheme)
 - [Emphasis](#Emphasis)
+- [EmphasisItemStyle](#EmphasisItemStyle)
+- [EmphasisLabelLine](#EmphasisLabelLine)
+- [EmphasisLabelStyle](#EmphasisLabelStyle)
 - [EndLabelStyle](#EndLabelStyle)
 - [IconStyle](#IconStyle)
 - [ImageStyle](#ImageStyle)
@@ -103,7 +109,6 @@
 - [RadarAxisTheme](#RadarAxisTheme)
 - [RadiusAxisTheme](#RadiusAxisTheme)
 - [SerieData](#SerieData)
- [SerieDataBaseInfo](#SerieDataBaseInfo)
 - [SerieSymbol](#SerieSymbol)
 - [SerieTheme](#SerieTheme)
 - [StageColor](#StageColor)
@@ -116,13 +121,16 @@
 - [TitleStyle](#TitleStyle)
 - [TitleTheme](#TitleTheme)
 - [TooltipTheme](#TooltipTheme)
- [VisualMapPieces](#VisualMapPieces)
+- [VisualMapRange](#VisualMapRange)
 - [VisualMapTheme](#VisualMapTheme)

 ## ISerieExtraComponent Serie额外组件

 - [AreaStyle](#AreaStyle)
 - [Emphasis](#Emphasis)
+- [EmphasisItemStyle](#EmphasisItemStyle)
+- [EmphasisLabelLine](#EmphasisLabelLine)
+- [EmphasisLabelStyle](#EmphasisLabelStyle)
 - [ImageStyle](#ImageStyle)
 - [LabelLine](#LabelLine)
 - [LabelStyle](#LabelStyle)
@@ -133,12 +141,14 @@

 - [AreaStyle](#AreaStyle)
 - [Emphasis](#Emphasis)
+- [EmphasisItemStyle](#EmphasisItemStyle)
+- [EmphasisLabelLine](#EmphasisLabelLine)
+- [EmphasisLabelStyle](#EmphasisLabelStyle)
 - [ImageStyle](#ImageStyle)
 - [ItemStyle](#ItemStyle)
 - [LabelLine](#LabelLine)
 - [LabelStyle](#LabelStyle)
 - [LineStyle](#LineStyle)
- [SerieDataBaseInfo](#SerieDataBaseInfo)
 - [SerieSymbol](#SerieSymbol)
 - [TitleStyle](#TitleStyle)

@@ -414,6 +424,45 @@ Inherits or Implemented: [Serie](#Serie),[INeedSerieContainer](#INeedSerieContai
 ## `ChildComponent`


+## `Comment`
+
+Inherits or Implemented: [MainComponent](#MainComponent)
+
+图表注解组件。
+
+|field|default|comment|
+|--|--|--|
+| `show` |true | 是否显示注解组件。 |
+| `labelStyle` | | 所有组件的文本样式。 [LabelStyle](LabelStyle)|
+| `markStyle` | | 所有组件的文本样式。 [CommentMarkStyle](CommentMarkStyle)|
+| `items` | |  |
+
+## `CommentItem`
+
+Inherits or Implemented: [ChildComponent](#ChildComponent)
+
+注解项。
+
+|field|default|comment|
+|--|--|--|
+| `show` |true | 是否显示当前注解项。 |
+| `content` | | 注解的文本内容。 |
+| `position` | | 注解项的位置坐标。 |
+| `markRect` | |  |
+| `markStyle` | |  [CommentMarkStyle](CommentMarkStyle)|
+| `labelStyle` | | 注解项的文本样式。 [LabelStyle](LabelStyle)|
+
+## `CommentMarkStyle`
+
+Inherits or Implemented: [ChildComponent](#ChildComponent)
+
+注解项。
+
+|field|default|comment|
+|--|--|--|
+| `show` |true | 是否显示当前注解项。 |
+| `lineStyle` | |  [LineStyle](LineStyle)|
+
 ## `ComponentTheme`

 Inherits or Implemented: [ChildComponent](#ChildComponent)
@@ -516,6 +565,27 @@ Inherits or Implemented: [ChildComponent](#ChildComponent),[ISerieExtraComponent
 | `labelLine` | |  [LabelLine](LabelLine)|
 | `itemStyle` | | 图形样式。 [ItemStyle](ItemStyle)|

+## `EmphasisItemStyle`
+
+Inherits or Implemented: [ItemStyle](#ItemStyle),[ISerieExtraComponent](#ISerieExtraComponent),[ISerieDataComponent](#ISerieDataComponent)
+
+高亮的图形样式
+
+
+## `EmphasisLabelLine`
+
+Inherits or Implemented: [LabelLine](#LabelLine),[ISerieExtraComponent](#ISerieExtraComponent),[ISerieDataComponent](#ISerieDataComponent)
+
+高亮的标签引导线样式
+
+
+## `EmphasisLabelStyle`
+
+Inherits or Implemented: [LabelStyle](#LabelStyle),[ISerieExtraComponent](#ISerieExtraComponent),[ISerieDataComponent](#ISerieDataComponent)
+
+高亮的标签样式
+
+
 ## `EndLabelStyle`

 Inherits or Implemented: [LabelStyle](#LabelStyle)
@@ -704,11 +774,13 @@ Inherits or Implemented: [MainComponent](#MainComponent),[IPropertyChanged](#IPr
 | `itemHeight` |12.0f | 图例标记的图形高度。 [default:12f] |
 | `itemGap` |10f | 图例每项之间的间隔。横向布局时为水平间隔，纵向布局时为纵向间隔。 [default:10f] |
 | `itemAutoColor` |true | 图例标记的图形是否自动匹配颜色。 [default:true] |
-| `textAutoColor` |false | 图例标记的文本是否自动匹配颜色。 [default:false] |
+| `itemOpacity` |1 | 图例标记的图形的颜色透明度。 |
 | `formatter` | |  |
+| `numericFormatter` | | 标准数字格式字符串。用于将数值格式化显示为字符串。 使用Axx的形式：A是格式说明符的单字符，支持C货币、D十进制、E指数、F定点数、G常规、N数字、P百分比、R往返、X十六进制的。xx是精度说明，从0-99。 参考：https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/standard-numeric-format-strings |
 | `labelStyle` | | 文本样式。 [LabelStyle](LabelStyle)|
 | `data` | | If data is not specified, it will be auto collected from series. |
 | `icons` | | 自定义的图例标记图形。 |
+| `colors` | |  |

 ## `LegendTheme`

@@ -749,7 +821,7 @@ Inherits or Implemented: [ChildComponent](#ChildComponent),[ISerieExtraComponent
 |field|default|comment|
 |--|--|--|
 | `show` | | 是否显示箭头。 |
-| `position` | | 箭头位置。</br>`LineArrow.Position`:</br>- `End`: 末端箭头</br>- `Start`: 头端箭头</br>|
+| `position` | | 箭头位置。</br>`LabelStyle.Position`:</br>- `Default`: 标签的位置。</br>- `Outside`: 饼图扇区外侧，通过视觉引导线连到相应的扇区。</br>- `Inside`: 饼图扇区内部。</br>- `Center`: 在饼图中心位置。</br>- `Top`: 图形标志的顶部。</br>- `Bottom`: 图形标志的底部。</br>- `Left`: 图形标志的左边。</br>- `Right`: 图形标志的右边。</br>- `Start`: 线的起始点。</br>- `Middle`: 线的中点。</br>- `End`: 线的结束点。</br>|
 | `arrow` | | 箭头。 [ArrowStyle](ArrowStyle)|

 ## `LineStyle`
@@ -954,7 +1026,9 @@ Inherits or Implemented: [BaseSerie](#BaseSerie),[IComparable](#IComparable)
 | `lineArrows` | |  |
 | `areaStyles` | |  |
 | `titleStyles` | |  |
-| `emphases` | |  |
+| `emphasisItemStyles` | |  |
+| `emphasisLabels` | |  |
+| `emphasisLabelLines` | |  |
 | `index` | | 系列索引。 |
 | `show` |true | 系列是否显示在图表上。 |
 | `coordSystem` | | 使用的坐标系。 |
@@ -977,8 +1051,8 @@ Inherits or Implemented: [BaseSerie](#BaseSerie),[IComparable](#IComparable)
 | `lineType` | | 折线图样式类型。</br>`LineType`:</br>- `Normal`: the normal line chart， 普通折线图。</br>- `Smooth`: the smooth line chart， 平滑曲线。</br>- `StepStart`: 阶梯线图：当前点。</br>- `StepMiddle`: 阶梯线图：当前点和下一个点的中间。</br>- `StepEnd`: 阶梯线图：下一个拐点。</br>|
 | `barType` | | 柱形图类型。</br>`BarType`:</br>- `Normal`: 普通柱形图</br>- `Zebra`: 斑马柱形图</br>- `Capsule`: 胶囊柱形图</br>|
 | `barPercentStack` |false | 柱形图是否为百分比堆积。相同stack的serie只要有一个barPercentStack为true，则就显示成百分比堆叠柱状图。 |
-| `barWidth` |0.6f | 柱条的宽度，不设时自适应。支持设置成相对于类目宽度的百分比。 |
-| `barGap` |0.3f; // 30 | <para>Set barGap as '-1' can overlap bars that belong to different series, which is useful when making a series of bar be background. |
+| `barWidth` |0 | 柱条的宽度，不设时自适应。支持设置成相对于类目宽度的百分比。 |
+| `barGap` |0.1f | <para>Set barGap as '-1' can overlap bars that belong to different series, which is useful when making a series of bar be background. |
 | `barZebraWidth` |4f | 斑马线的粗细。 |
 | `barZebraGap` |2f | 斑马线的间距。 |
 | `min` | | 最小值。 |
@@ -1035,29 +1109,21 @@ Inherits or Implemented: [ChildComponent](#ChildComponent)
 | `name` | | 数据项名称。 |
 | `id` | | 数据项的唯一id。唯一id不是必须设置的。 |
 | `parentId` | |  |
-| `baseInfos` | |  |
+| `ignore` | | 是否忽略数据。当为 true 时，数据不进行绘制。 |
+| `selected` | | 该数据项是否被选中。 |
+| `radius` | | 自定义半径。可用在饼图中自定义某个数据项的半径。 |
 | `itemStyles` | |  |
 | `labels` | |  |
 | `labelLines` | |  |
-| `emphases` | |  |
 | `symbols` | |  |
 | `lineStyles` | |  |
 | `areaStyles` | |  |
 | `titleStyles` | |  |
+| `emphasisItemStyles` | |  |
+| `emphasisLabels` | |  |
+| `emphasisLabelLines` | |  |
 | `data` | | 可指定任意维数的数值列表。 |

-## `SerieDataBaseInfo`
-
-Inherits or Implemented: [ChildComponent](#ChildComponent),[ISerieDataComponent](#ISerieDataComponent)
-
-数据项的其他基础数据。
-
-|field|default|comment|
-|--|--|--|
-| `ignore` |false | 是否忽略数据。当为 true 时，数据不进行绘制。 |
-| `selected` | | 该数据项是否被选中。 |
-| `radius` | | 自定义半径。可用在饼图中自定义某个数据项的半径。 |
-
 ## `SerieSymbol`

 Inherits or Implemented: [SymbolStyle](#SymbolStyle),[ISerieDataComponent](#ISerieDataComponent)
@@ -1392,11 +1458,10 @@ Inherits or Implemented: [MainComponent](#MainComponent)
 | `location` | | 组件显示的位置。 [Location](Location)|
 | `workOnLine` |true | 组件是否对LineChart的LineStyle有效。 |
 | `workOnArea` |false | 组件是否对LineChart的AreaStyle有效。 |
-| `inRange` | | 定义 在选中范围中 的视觉颜色。 |
 | `outOfRange` | | 定义 在选中范围外 的视觉颜色。 |
-| `pieces` | | 分段式每一段的相关配置。 |
+| `inRange` | | 分段式每一段的相关配置。 |

-## `VisualMapPieces`
+## `VisualMapRange`

 Inherits or Implemented: [ChildComponent](#ChildComponent)