修复Axis的更新数据时效果不顺畅的问题

2026-05-27 11:40:13 +00:00 · 2023-11-24 08:29:55 +08:00
parent 1f970cbb36
commit 45be0748aa
20 changed files with 418 additions and 233 deletions
--- a/Documentation~/en/api.md
+++ b/Documentation~/en/api.md
@@ -22,6 +22,7 @@ slug: /api
 - [AreaStyle](#areastyle)
 - [ArrowStyle](#arrowstyle)
 - [Axis](#axis)
+- [AxisAnimation](#axisanimation)
 - [AxisContext](#axiscontext)
 - [AxisHandler&lt;T&gt;](#axishandlert)
 - [AxisHelper](#axishelper)
@@ -451,6 +452,19 @@ The axis in rectangular coordinate.
 |UpdateIcon()||public void UpdateIcon(int index, Sprite icon)<br/>更新图标 |
 |UpdateZeroOffset()||public void UpdateZeroOffset(float axisLength)|

+## AxisAnimation
+
+> class in XCharts.Runtime / Inherits from: [ChildComponent](#childcomponent)
+
+> Since `v3.9.0`
+
+animation style of axis.
+
+|public method|since|description|
+|--|--|--|
+|Clone()||public AxisAnimation Clone()|
+|Copy()||public void Copy(AxisAnimation animation)|
+
 ## AxisContext

 > class in XCharts.Runtime / Inherits from: [MainComponentContext](#maincomponentcontext)
@@ -1114,7 +1128,7 @@ Configurations of blur state.

 ## ChildComponent

-> class in XCharts.Runtime / Subclasses: [AnimationStyle](#animationstyle),[AxisName](#axisname),[AxisSplitArea](#axissplitarea),[AreaStyle](#areastyle),[ArrowStyle](#arrowstyle),[BaseLine](#baseline),[IconStyle](#iconstyle),[ImageStyle](#imagestyle),[ItemStyle](#itemstyle),[Level](#level),[LevelStyle](#levelstyle),[LineArrow](#linearrow),[LineStyle](#linestyle),[Location](#location),[MLValue](#mlvalue),[MarqueeStyle](#marqueestyle),[Padding](#padding),[StageColor](#stagecolor),[SymbolStyle](#symbolstyle),[TextLimit](#textlimit),[TextStyle](#textstyle),[CommentItem](#commentitem),[CommentMarkStyle](#commentmarkstyle),[LabelLine](#labelline),[LabelStyle](#labelstyle),[MarkAreaData](#markareadata),[MarkLineData](#marklinedata),[StateStyle](#statestyle),[VisualMapRange](#visualmaprange),[UIComponentTheme](#uicomponenttheme),[SerieData](#seriedata),[ComponentTheme](#componenttheme),[SerieTheme](#serietheme),[ThemeStyle](#themestyle) 
+> class in XCharts.Runtime / Subclasses: [AnimationStyle](#animationstyle),[AxisAnimation](#axisanimation),[AxisName](#axisname),[AxisSplitArea](#axissplitarea),[AreaStyle](#areastyle),[ArrowStyle](#arrowstyle),[BaseLine](#baseline),[IconStyle](#iconstyle),[ImageStyle](#imagestyle),[ItemStyle](#itemstyle),[Level](#level),[LevelStyle](#levelstyle),[LineArrow](#linearrow),[LineStyle](#linestyle),[Location](#location),[MLValue](#mlvalue),[MarqueeStyle](#marqueestyle),[Padding](#padding),[StageColor](#stagecolor),[SymbolStyle](#symbolstyle),[TextLimit](#textlimit),[TextStyle](#textstyle),[CommentItem](#commentitem),[CommentMarkStyle](#commentmarkstyle),[LabelLine](#labelline),[LabelStyle](#labelstyle),[MarkAreaData](#markareadata),[MarkLineData](#marklinedata),[StateStyle](#statestyle),[VisualMapRange](#visualmaprange),[UIComponentTheme](#uicomponenttheme),[SerieData](#seriedata),[ComponentTheme](#componenttheme),[SerieTheme](#serietheme),[ThemeStyle](#themestyle) 


 |public method|since|description|
@@ -2599,6 +2613,7 @@ the data of serie event.
 |GetLastStackSerie()||public static Serie GetLastStackSerie(List&lt;Serie&gt; series, Serie serie)<br/>获得上一个同堆叠且显示的serie。 |
 |GetLegalSerieNameList()||public static List&lt;string&gt; GetLegalSerieNameList(List&lt;Serie&gt; series)|
 |GetMaxSerieDataCount()||public static int GetMaxSerieDataCount(List&lt;Serie&gt; series)|
+|GetMinAnimationDuration()||public static float GetMinAnimationDuration(List&lt;Serie&gt; series)|
 |GetNameColor()||public static Color GetNameColor(BaseChart chart, int index, string name)|
 |GetStackSeries()||public static void GetStackSeries(List&lt;Serie&gt; series, ref Dictionary&lt;int, List&lt;Serie&gt;&gt; stackSeries)<br/>获得堆叠系列列表 |
 |IsAnyClipSerie()||public static bool IsAnyClipSerie(List&lt;Serie&gt; series)<br/>是否有需裁剪的serie。 |
--- a/Documentation~/en/configuration.md
+++ b/Documentation~/en/configuration.md
@@ -81,6 +81,7 @@ import APITable from '@site/src/components/APITable';
 - [AnimationStyle](#animationstyle)
 - [AreaStyle](#areastyle)
 - [ArrowStyle](#arrowstyle)
+- [AxisAnimation](#axisanimation)
 - [AxisLabel](#axislabel)
 - [AxisLine](#axisline)
 - [AxisMinorSplitLine](#axisminorsplitline)
@@ -421,6 +422,7 @@ The axis in rectangular coordinate.
 |axisLabel|||axis label. [AxisLabel](#axislabel)|
 |splitLine|||axis split line. [AxisSplitLine](#axissplitline)|
 |splitArea|||axis split area. [AxisSplitArea](#axissplitarea)|
+|animation|||animation of axis. [AxisAnimation](#axisanimation)|
 |minorTick||v3.2.0|axis minor tick. [AxisMinorTick](#axisminortick)|
 |minorSplitLine||v3.2.0|axis minor split line. [AxisMinorSplitLine](#axisminorsplitline)|
 |indicatorLabel||v3.4.0|Style of axis tooltip indicator label. [LabelStyle](#labelstyle)|
@@ -429,6 +431,29 @@ The axis in rectangular coordinate.
 </APITable>
 ```

+## AxisAnimation
+
+> class in XCharts.Runtime / Inherits from: [ChildComponent](#childcomponent)
+
+> Since `v3.9.0`
+
+animation style of axis.
+
+```mdx-code-block
+<APITable name="AxisAnimation">
+```
+
+
+|field|default|since|comment|
+|--|--|--|--|
+|show|true||whether to enable animation.
+|duration|||the duration of animation (ms). When it is set to 0, the animation duration will be automatically calculated according to the serie.
+|unscaledTime|||Animation updates independently of Time.timeScale.
+
+```mdx-code-block
+</APITable>
+```
+
 ## AxisLabel

 > class in XCharts.Runtime / Inherits from: [LabelStyle](#labelstyle)
@@ -719,7 +744,7 @@ Configurations of blur state.

 ## ChildComponent

-> class in XCharts.Runtime / Subclasses: [AnimationStyle](#animationstyle), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MLValue](#mlvalue), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)
+> class in XCharts.Runtime / Subclasses: [AnimationStyle](#animationstyle), [AxisAnimation](#axisanimation), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MLValue](#mlvalue), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)

 ## Comment

--- a/Documentation~/zh/api.md
+++ b/Documentation~/zh/api.md
--- a/Documentation~/zh/changelog.md
+++ b/Documentation~/zh/changelog.md
@@ -74,6 +74,7 @@ slug: /changelog

 版本要点：

+* 增加`Axis`的`Animation`，完善数据变更动画效果
 * 增加`Axis`的对数轴子刻度的支持
 * 增加`MarkLine`的`onTop`设置是否显示在最上层
 * 增加`UITable`表格组件的轮播功能，重构`UITable`
@@ -82,6 +83,8 @@ slug: /changelog

 日志详情：

+* (2023.11.24) 修复`Axis`的更新数据时效果不顺畅的问题
+* (2023.11.23) 增加`Axis`的`Animation`支持动画效果
 * (2023.11.16) 取消`Legend`的`formatter`，用`LabelStyle`的代替
 * (2023.11.14) 完善`LabelStyle`的`formatter`的注释和文档(#291)
 * (2023.11.11) 修复`Documentation`部分注释生成文档不完整的问题 (#290)
--- a/Documentation~/zh/configuration.md
+++ b/Documentation~/zh/configuration.md
@@ -81,6 +81,7 @@ import APITable from '@site/src/components/APITable';
 - [AnimationStyle](#animationstyle)
 - [AreaStyle](#areastyle)
 - [ArrowStyle](#arrowstyle)
+- [AxisAnimation](#axisanimation)
 - [AxisLabel](#axislabel)
 - [AxisLine](#axisline)
 - [AxisMinorSplitLine](#axisminorsplitline)
@@ -414,6 +415,7 @@ import APITable from '@site/src/components/APITable';
 |axisLabel|||坐标轴刻度标签。 [AxisLabel](#axislabel)|
 |splitLine|||坐标轴分割线。 [AxisSplitLine](#axissplitline)|
 |splitArea|||坐标轴分割区域。 [AxisSplitArea](#axissplitarea)|
+|animation|||坐标轴动画。 [AxisAnimation](#axisanimation)|
 |minorTick||v3.2.0|坐标轴次刻度。 [AxisMinorTick](#axisminortick)|
 |minorSplitLine||v3.2.0|坐标轴次分割线。 [AxisMinorSplitLine](#axisminorsplitline)|
 |indicatorLabel||v3.4.0|指示器文本的样式。Tooltip为Cross时使用。 [LabelStyle](#labelstyle)|
@@ -422,6 +424,28 @@ import APITable from '@site/src/components/APITable';
 </APITable>
 ```

+## AxisAnimation
+
+> class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)
+
+> 从 `v3.9.0` 开始支持
+
+坐标轴动画配置。
+
+```mdx-code-block
+<APITable name="AxisAnimation">
+```
+
+|参数|默认|版本|描述|
+|--|--|--|--|
+|show|true||是否开启动画。
+|duration|||动画时长(ms)。 默认设置为0时，会自动获取serie的动画时长。
+|unscaledTime|||动画是否受TimeScaled的影响。默认为 false 受TimeScaled的影响。
+
+```mdx-code-block
+</APITable>
+```
+
 ## AxisLabel

 > class in XCharts.Runtime / 继承自: [LabelStyle](#labelstyle)
@@ -701,7 +725,7 @@ import APITable from '@site/src/components/APITable';

 ## ChildComponent

-> class in XCharts.Runtime / 子类: [AnimationStyle](#animationstyle), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MLValue](#mlvalue), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)
+> class in XCharts.Runtime / 子类: [AnimationStyle](#animationstyle), [AxisAnimation](#axisanimation), [AxisName](#axisname), [AxisSplitArea](#axissplitarea), [AreaStyle](#areastyle), [ArrowStyle](#arrowstyle), [BaseLine](#baseline), [IconStyle](#iconstyle), [ImageStyle](#imagestyle), [ItemStyle](#itemstyle), [Level](#level), [LevelStyle](#levelstyle), [LineArrow](#linearrow), [LineStyle](#linestyle), [Location](#location), [MLValue](#mlvalue), [MarqueeStyle](#marqueestyle), [Padding](#padding), [StageColor](#stagecolor), [SymbolStyle](#symbolstyle), [TextLimit](#textlimit), [TextStyle](#textstyle), [CommentItem](#commentitem), [CommentMarkStyle](#commentmarkstyle), [LabelLine](#labelline), [LabelStyle](#labelstyle), [MarkAreaData](#markareadata), [MarkLineData](#marklinedata), [StateStyle](#statestyle), [VisualMapRange](#visualmaprange), [UIComponentTheme](#uicomponenttheme), [SerieData](#seriedata), [ComponentTheme](#componenttheme), [SerieTheme](#serietheme), [ThemeStyle](#themestyle)

 ## Comment