3.14.0

Documentation~/zh/api.md

@@ -405,7 +405,7 @@ public AnimationDelayFunction delayFunction
 ### AnimationInfo.duration
 
 public float duration  
-动画的时长。
+动画的时长。默认用于计算动画的速度。也可以通过speed指定速度。
 
 ### AnimationInfo.durationFunction
 
@@ -432,6 +432,11 @@ public Action OnAnimationStart
 public bool reverse  
 是否开启反向动画效果。
 
+### AnimationInfo.speed
+
+public float speed  
+动画的速度。当指定speed时，duration将失效。默认为0，表示不指定速度。
+
 ### AnimationInfo.End
 
 public void End()  
@@ -1042,6 +1047,10 @@ public bool needAnimation
 public List<string> runtimeData  
 数值轴时每个tick的数值。
 
+### AxisContext.sortedDataIndices
+
+public List<int> sortedDataIndices  
+
 ## AxisHandler<T>
 
 class in XCharts / 继承自: [MainComponentHandler](#maincomponenthandler)
@@ -1170,7 +1179,7 @@ public void Copy(AxisLabel axisLabel)
 
 ### AxisLabel.GetFormatterContent
 
-public override string GetFormatterContent(int labelIndex, double value, double minValue, double maxValue, bool isLog = false)  
+public override string GetFormatterContent(int labelIndex, int totalIndex, double value, double minValue, double maxValue, bool isLog = false)  
 
 
 ### AxisLabel.IsNeedShowLabel
@@ -1383,6 +1392,10 @@ public int containerIndex
 
 public int containterInstanceId  
 
+### Bar.useSortData
+
+public override bool useSortData  
+
 ### Bar.AddDefaultSerie
 
 public static Serie AddDefaultSerie(BaseChart chart, string serieName)  
@@ -1941,6 +1954,10 @@ public T GetOrAddChartComponent<T>() where T : MainComponent
 
 public Painter GetPainter(int index)  
 
+### BaseChart.GetRealtimeSortSerie
+
+public Serie GetRealtimeSortSerie(int gridIndex)  
+
 ### BaseChart.GetSerie
 
 public Serie GetSerie(int serieIndex)  
@@ -1953,19 +1970,19 @@ public T GetSerie<T>(int serieIndex) where T : Serie
 
 ### BaseChart.GetSerieBarGap<T>
 
-public float GetSerieBarGap<T>() where T : Serie  
+public float GetSerieBarGap<T>(int gridIndex) where T : Serie  
 
 ### BaseChart.GetSerieBarRealCount<T>
 
-public int GetSerieBarRealCount<T>() where T : Serie  
+public int GetSerieBarRealCount<T>(int gridIndex) where T : Serie  
 
 ### BaseChart.GetSerieIndexIfStack<T>
 
-public int GetSerieIndexIfStack<T>(Serie currSerie) where T : Serie  
+public int GetSerieIndexIfStack<T>(Serie currSerie, int gridIndex) where T : Serie  
 
 ### BaseChart.GetSerieSameStackTotalValue<T>
 
-public double GetSerieSameStackTotalValue<T>(string stack, int dataIndex) where T : Serie  
+public double GetSerieSameStackTotalValue<T>(string stack, int dataIndex, int gridIndex) where T : Serie  
 
 ### BaseChart.GetSeriesMinMaxValue
 
@@ -1973,11 +1990,11 @@ public virtual void GetSeriesMinMaxValue(Axis axis, int axisIndex, out double te
 
 ### BaseChart.GetSerieTotalGap<T>
 
-public float GetSerieTotalGap<T>(float categoryWidth, float gap, int index) where T : Serie  
+public float GetSerieTotalGap<T>(float categoryWidth, float gap, int index, int gridIndex) where T : Serie  
 
 ### BaseChart.GetSerieTotalWidth<T>
 
-public float GetSerieTotalWidth<T>(float categoryWidth, float gap, int realBarCount) where T : Serie  
+public float GetSerieTotalWidth<T>(float categoryWidth, float gap, int realBarCount, int gridIndex) where T : Serie  
 
 ### BaseChart.GetTitlePosition
 
@@ -2007,6 +2024,10 @@ public bool HasChartComponent(Type type)
 
 public bool HasChartComponent<T>()  
 
+### BaseChart.HasRealtimeSortSerie
+
+public bool HasRealtimeSortSerie(int gridIndex)  
+
 ### BaseChart.HasSerie
 
 public bool HasSerie(Type type)  
@@ -3082,6 +3103,10 @@ public static List<string> ParseStringFromString(string jsonData)
 
 public static void RemoveComponent<T>(GameObject gameObject)  
 
+### ChartHelper.RemoveTMPComponents
+
+public static void RemoveTMPComponents(GameObject gameObject)  
+
 ### ChartHelper.RotateRound
 
 public static Vector3 RotateRound(Vector3 position, Vector3 center, Vector3 axis, float angle)  
@@ -3434,10 +3459,9 @@ class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)
 
 注解项。
 
-### CommentItem.content
+### CommentItem.labelObject
 
-public string content  
-注解的文本内容。支持模板参数，可以参考Tooltip的itemFormatter。
+public ChartLabel labelObject  
 
 ### CommentItem.markRect
 
@@ -3886,9 +3910,13 @@ public static bool NeedFormat(string content)
 
 ### FormatterHelper.ReplaceAxisLabelContent
 
-public static void ReplaceAxisLabelContent(ref string content, string value)  
+public static void ReplaceAxisLabelContent(ref string content, string value, int index, int totalIndex)  
 
 
+### FormatterHelper.ReplaceIndexContent
+
+public static void ReplaceIndexContent(ref string content, int currIndex, int totalIndex)  
+
 ### FormatterHelper.TrimAndReplaceLine
 
 public static string TrimAndReplaceLine(string content)  
@@ -4399,7 +4427,7 @@ public override void ClearData()
 
 ### Indicator.GetFormatterIndicatorContent
 
-public string GetFormatterIndicatorContent(string indicatorName)  
+public string GetFormatterIndicatorContent(string indicatorName, int index, int totalIndex)  
 
 
 ### Indicator.GetIndicator
@@ -4650,12 +4678,12 @@ public Color GetColor(Color defaultColor)
 
 ### LabelStyle.GetFormatterContent
 
-public virtual string GetFormatterContent(int labelIndex, double value, double minValue, double maxValue, bool isLog = false)  
+public virtual string GetFormatterContent(int labelIndex, int totalIndex, double value, double minValue, double maxValue, bool isLog = false)  
 
 
 ### LabelStyle.GetFormatterDateTime
 
-public string GetFormatterDateTime(int labelIndex, double value, double minValue, double maxValue)  
+public string GetFormatterDateTime(int labelIndex, int totalIndex, double value, double minValue, double maxValue)  
 
 ### LabelStyle.GetOffset
 
@@ -6719,7 +6747,7 @@ public double GetData(int index, int dimension, DataZoom dataZoom = null)
 
 ### Serie.GetDataList
 
-public List<SerieData> GetDataList(DataZoom dataZoom = null)  
+public List<SerieData> GetDataList(DataZoom dataZoom = null, bool sorted = false)  
 获得系列的数据列表
 
 ### Serie.GetDataTotal
@@ -7026,6 +7054,10 @@ public SelectStyle selectStyle
 public bool show  
 该数据项是否要显示。
 
+### SerieData.sortIndex
+
+public int sortIndex  
+
 ### SerieData.state
 
 public SerieState state  
@@ -7172,7 +7204,7 @@ public void SetIconActive(bool flag)
 
 ### SerieData.SetLabelActive
 
-public void SetLabelActive(bool flag)  
+public void SetLabelActive(bool flag, bool force = false)  
 
 ### SerieData.SetPolygon
 
@@ -7949,7 +7981,7 @@ class in XCharts.Runtime / 继承自: [SymbolStyle](#symbolstyle),[ISerieDataCom
 
 ### SerieSymbol.GetSize
 
-public float GetSize(List<double> data, float themeSize)  
+public float GetSize(SerieData serieData, float themeSize)  
 根据指定的sizeType获得标记的大小
 
 ### SerieSymbol.Reset

Documentation~/zh/changelog.md

@@ -6,6 +6,7 @@ slug: /changelog
 # 更新日志
 
 [master](#master)  
+[v3.14.0](#v3140)  
 [v3.13.0](#v3130)  
 [v3.12.1](#v3121)  
 [v3.12.0](#v3120)  
@@ -79,6 +80,19 @@ slug: /changelog
 
 ## master
 
+## v3.14.0
+
+版本要点：
+
+* 新增`Bar`的实时排序功能
+* 新增`Tooltip`的`itemFormatter`支持`\n`换行
+* 新增`AxisLabel`的格式化支持`{index}`
+* 新增`Animation`的`speed`可指定动画速度
+* 优化`Tooltip`的列对齐方式
+
+日志详情：
+
+* (2025.03.15) 发布`v3.14.0`版本
 * (2025.03.09) 修复`Bar`在同一个`Chart`不同`Grid`里时绘制有些异常的问题
 * (2025.03.07) 增加`Animation`的`speed`可指定动画速度
 * (2025.03.06) 优化`Animation`的新增动画表现

Documentation~/zh/configuration.md

@@ -276,7 +276,7 @@ class in XCharts.Runtime / 子类: [AnimationFadeIn](#animationfadein), [Animati
 
 `float` `1000` `v3.8.0`
 
-动画的时长。
+动画的时长。默认用于计算动画的速度。也可以通过speed指定速度。
 
 ### AnimationInfo.enable
 
@@ -290,6 +290,12 @@ class in XCharts.Runtime / 子类: [AnimationFadeIn](#animationfadein), [Animati
 
 是否开启反向动画效果。
 
+### AnimationInfo.speed
+
+`float` `0` `v3.14.0`
+
+动画的速度。当指定speed时，duration将失效。默认为0，表示不指定速度。
+
 ## AnimationInteraction
 
 class in XCharts.Runtime / 继承自: [AnimationInfo](#animationinfo)
@@ -2462,7 +2468,7 @@ class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent), [ISerie
 
 `string`
 
-标签内容字符串模版格式器。支持用 \n 换行。部分组件的格式器会不生效。<br/> 模板通配符有以下这些，部分只适用于固定的组件：<br/> `\{.\}`：圆点标记。<br/> `\{a\}`：系列名。<br/> `\{b\}`：X轴类目名或数据名。<br/> `\{c\}`：数据值。<br/> `\{d\}`：百分比。<br/> `\{e\}`：数据名。<br/> `\{f\}`：数据和。<br/> `\{g\}`：数据总个数。<br/> `\{h\}`：十六进制颜色值。<br/> `\{y\}`：Y轴的类目名。<br/> `\{value\}`：坐标轴或图例的值。<br/> 以下通配符适用UITable组件：<br/> `\{name\}`： 表格的行名。<br/> `\{index\}`：表格的行号。<br/> 以下通配符适用UIStatistc组件：<br/> `\{title\}`：标题文本。<br/> `\{dd\}`：天。<br/> `\{hh\}`：小时。<br/> `\{mm\}`：分钟。<br/> `\{ss\}`：秒。<br/> `\{fff\}`：毫秒。<br/> `\{d\}`：天。<br/> `\{h\}`：小时。<br/> `\{m\}`：分钟。<br/> `\{s\}`：秒。<br/> `\{f\}`：毫秒。<br/> 示例：“\{b\}:\{c\}”
+标签内容字符串模版格式器。支持用 \n 换行。部分组件的格式器会不生效。<br/> 模板通配符有以下这些，部分只适用于固定的组件：<br/> `\{.\}`：圆点标记。<br/> `\{a\}`：系列名。<br/> `\{b\}`：X轴类目名或数据名。<br/> `\{c\}`：数据值。<br/> `\{d\}`：百分比。<br/> `\{e\}`：数据名。<br/> `\{f\}`：数据和。<br/> `\{g\}`：数据总个数。<br/> `\{h\}`：十六进制颜色值。<br/> `\{y\}`：Y轴的类目名。<br/> `\{value\}`：坐标轴或图例的值。<br/> `\{index\}`：坐标轴编号。<br/> 以下通配符适用UITable组件：<br/> `\{name\}`： 表格的行名。<br/> `\{index\}`：表格的行号。<br/> 以下通配符适用UIStatistc组件：<br/> `\{title\}`：标题文本。<br/> `\{dd\}`：天。<br/> `\{hh\}`：小时。<br/> `\{mm\}`：分钟。<br/> `\{ss\}`：秒。<br/> `\{fff\}`：毫秒。<br/> `\{d\}`：天。<br/> `\{h\}`：小时。<br/> `\{m\}`：分钟。<br/> `\{s\}`：秒。<br/> `\{f\}`：毫秒。<br/> 示例：“\{b\}:\{c\}”
 
 ### LabelStyle.height
 
@@ -3755,6 +3761,12 @@ class in XCharts.Runtime / 继承自: [BaseSerie](#baseserie), [IComparable](htt
 
 半径。radius[0]表示内径，radius[1]表示外径。
 
+### Serie.realtimeSort
+
+`bool` `false` `v3.14.0`
+
+是否开启实时排序，用来实现动态排序图效果。目前仅在Bar中生效。
+
 ### Serie.right
 
 `float`
@@ -4816,11 +4828,17 @@ class in XCharts.Runtime / 继承自: [MainComponent](#maincomponent)
 
 边框线宽。
 
+### Tooltip.columnGapWidths
+
+`List<float>` `v3.14.0`
+
+内容部分的列间距。当只有一列时，只表示第二列的间距。
+
 ### Tooltip.contentLabelStyles
 
 `List<LabelStyle>`
 
-内容部分的文本样式列表。和列一一对应。
+内容部分的列文本样式列表。第一个表示第一列的文本样式，以此类推。
 
 ### Tooltip.fixedHeight