增加Animation的Exchange排序交换动画

Documentation~/zh/api.md

@@ -13,6 +13,7 @@ slug: /api
 - [AnimationAddition](#animationaddition)
 - [AnimationChange](#animationchange)
 - [AnimationEasing](#animationeasing)
+- [AnimationExchange](#animationexchange)
 - [AnimationFadeIn](#animationfadein)
 - [AnimationFadeOut](#animationfadeout)
 - [AnimationHiding](#animationhiding)
@@ -70,6 +71,7 @@ slug: /api
 - [ColorUtil](#colorutil)
 - [Comment](#comment)
 - [CommentItem](#commentitem)
+- [CommentLayer](#commentlayer)
 - [CommentMarkStyle](#commentmarkstyle)
 - [ComponentHandlerAttribute](#componenthandlerattribute)
 - [ComponentHelper](#componenthelper)
@@ -360,6 +362,14 @@ class in XCharts.Runtime
 
 - `Linear`: 
 
+## AnimationExchange
+
+class in XCharts.Runtime / 继承自: [AnimationInfo](#animationinfo)
+
+> 从 `v3.15.0` 开始支持
+
+数据交换动画。一般用于图表数据排序时顺序变化的动画。
+
 ## AnimationFadeIn
 
 class in XCharts.Runtime / 继承自: [AnimationInfo](#animationinfo)
@@ -386,7 +396,7 @@ class in XCharts.Runtime / 继承自: [AnimationInfo](#animationinfo)
 
 ## AnimationInfo
 
-class in XCharts.Runtime / 子类: [AnimationFadeIn](#animationfadein),[AnimationFadeOut](#animationfadeout),[AnimationChange](#animationchange),[AnimationAddition](#animationaddition),[AnimationHiding](#animationhiding),[AnimationInteraction](#animationinteraction) 
+class in XCharts.Runtime / 子类: [AnimationFadeIn](#animationfadein),[AnimationFadeOut](#animationfadeout),[AnimationChange](#animationchange),[AnimationAddition](#animationaddition),[AnimationHiding](#animationhiding),[AnimationInteraction](#animationinteraction),[AnimationExchange](#animationexchange) 
 
 > 从 `v3.8.0` 开始支持
 
@@ -531,7 +541,7 @@ public float GetWidth(float width)
 
 class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)
 
-动画组件，用于控制图表的动画播放。支持配置五种动画表现：FadeIn（渐入动画），FadeOut（渐出动画），Change（变更动画），Addition（新增动画），Interaction（交互动画）。 按作用的对象可以分为两类：SerieAnimation（系列动画）和DataAnimation（数据动画）。
+动画组件，用于控制图表的动画播放。支持配置五种动画表现：FadeIn（渐入动画），FadeOut（渐出动画），Change（变更动画），Addition（新增动画），Interaction（交互动画），Exchange（交换动画）。 按作用的对象可以分为两类：SerieAnimation（系列动画）和DataAnimation（数据动画）。
 
 ### AnimationStyle.addition
 
@@ -548,6 +558,11 @@ public AnimationChange change
 public bool enable  
 是否开启动画效果。
 
+### AnimationStyle.exchange
+
+public AnimationExchange exchange  
+交换动画配置。如在排序柱图中有效。
+
 ### AnimationStyle.fadeIn
 
 public AnimationFadeIn fadeIn  
@@ -639,6 +654,10 @@ public int GetCurrIndex()
 
 public float GetCurrRate()  
 
+### AnimationStyle.GetExchangeDuration
+
+public float GetExchangeDuration()  
+
 ### AnimationStyle.GetInteractionDuration
 
 public float GetInteractionDuration()  
@@ -1097,7 +1116,7 @@ public static float GetAxisValueDistance(GridCoord grid, Axis axis, float scaleW
 
 ### AxisHelper.GetAxisValueLength
 
-public static float GetAxisValueLength(GridCoord grid, Axis axis, float scaleWidth, double value)  
+public static float GetAxisValueLength(GridCoord grid, Axis axis, float scaleWidth, double value, float gap = 0)  
 获得数值value在坐标轴上对应的长度
 
 ### AxisHelper.GetAxisValuePosition
@@ -1674,6 +1693,10 @@ public Settings settings
 
 public ThemeStyle theme  
 
+### BaseChart.topPainter
+
+public Painter topPainter  
+
 ### BaseChart.typeListForComponent
 
 public Dictionary<Type, FieldInfo> typeListForComponent  
@@ -3428,13 +3451,20 @@ public static Color32 GetColor(string hexColorStr)
 
 class in XCharts.Runtime / 继承自: [MainComponent](#maincomponent),[IPropertyChanged](#ipropertychanged)
 
-图表注解组件。
+> 从 `v3.15.0` 开始支持
+
+图表注解组件。用于标注图表中的特殊信息。
 
 ### Comment.items
 
 public List<CommentItem> items  
 注解项。每个注解组件可以设置多个注解项。
 
+### Comment.layer
+
+public CommentLayer layer  
+注解的显示层级。
+
 ### Comment.show
 
 public bool show  
@@ -3443,10 +3473,12 @@ public bool show
 ### Comment.GetLabelStyle
 
 public LabelStyle GetLabelStyle(int index)  
+获取注解项的文本样式。
 
 ### Comment.GetMarkStyle
 
 public CommentMarkStyle GetMarkStyle(int index)  
+获取注解项的标记样式。
 
 ### Comment.OnChanged
 
@@ -3478,6 +3510,17 @@ public CommentMarkStyle markStyle
 public bool show  
 是否显示当前注解项。
 
+## CommentLayer
+
+class in XCharts.Runtime
+
+注解的显示层级。
+
+可选：
+
+- `Lower`: 注解在系列下方。
+- `Upper`: 注解在系列上方。
+
 ## CommentMarkStyle
 
 class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)
@@ -7257,6 +7300,10 @@ class in XCharts.Runtime
 
 public void Reset()  
 
+### SerieDataContext.UpdateExchangePosition
+
+public void UpdateExchangePosition(ref float x, ref float y, float totalTime)  
+
 ## SerieDataExtraFieldAttribute
 
 class in XCharts.Runtime / 继承自: [Attribute](https://docs.unity3d.com/ScriptReference/30_search.html?q=attribute)
@@ -7685,6 +7732,10 @@ public override void RefreshLabelInternal()
 
 public override void RefreshLabelNextFrame()  
 
+### SerieHandler<T>.RefreshTitleLabelInternal
+
+public void RefreshTitleLabelInternal()  
+
 ### SerieHandler<T>.RemoveComponent
 
 public override void RemoveComponent()