3.13.0

2026-05-22 08:50:10 +00:00 · 2025-01-01 20:15:29 +08:00
parent be6a91b4c2
commit 151ed168b5
6 changed files with 141 additions and 14 deletions
--- a/Documentation~/en/api.md
+++ b/Documentation~/en/api.md
@@ -1362,6 +1362,11 @@ class in XCharts.Runtime / Inherits from: [MainComponent](#maincomponent)

 Background component.

+### Background.rect
+
+public Rect rect  
+the rect of background.
+
 ### Background.SetDefaultValue

 public override void SetDefaultValue()  
@@ -2353,6 +2358,10 @@ class in XCharts.Runtime / Inherits from: [MaskableGraphic](https://docs.unity3d

 public virtual HideFlags chartHideFlags  

+### BaseGraph.childrenNodeNames
+
+public List&lt;string&gt; childrenNodeNames  
+
 ### BaseGraph.clickPos

 public Vector2 clickPos  
@@ -2411,6 +2420,10 @@ The x of graph.
 public float graphY  
 The y of graph.

+### BaseGraph.isDragingClick
+
+public bool isDragingClick  
+
 ### BaseGraph.isPointerClick

 public bool isPointerClick  
@@ -2759,6 +2772,10 @@ public float GetRuntimeBorderWidth()

 public float[] GetRuntimeCornerRadius()  

+### BorderStyle.IsCricle
+
+public bool IsCricle()  
+
 ## CalendarCoord

 class in XCharts.Runtime / Inherits from: [CoordSystem](#coordsystem),[IUpdateRuntimeData](#iupdateruntimedata),[ISerieContainer](#iseriecontainer)
@@ -2893,7 +2910,8 @@ public static void DestoryGameObject(GameObject go)

 ### ChartHelper.DestoryGameObjectByMatch

-public static void DestoryGameObjectByMatch(Transform parent, string containString)  
+public static void DestoryGameObjectByMatch(Transform parent, List&lt;string&gt; children)  
+

 ### ChartHelper.DestroyAllChildren

@@ -2940,7 +2958,8 @@ public static Vector3 GetLastValue(List&lt;Vector3&gt; list)

 ### ChartHelper.GetMaxCeilRate

-public static double GetMaxCeilRate(double value, double ceilRate)  
+public static float GetMaxCeilRate(float value, float ceilRate)  
+

 ### ChartHelper.GetMaxDivisibleValue

@@ -2952,7 +2971,8 @@ public static double GetMaxLogValue(double value, float logBase, bool isLogBaseE

 ### ChartHelper.GetMinCeilRate

-public static double GetMinCeilRate(double value, double ceilRate)  
+public static float GetMinCeilRate(float value, float ceilRate)  
+

 ### ChartHelper.GetMinDivisibleValue

@@ -5317,6 +5337,10 @@ public float runtimeTop
 public Vector3 GetPosition(float chartWidth, float chartHeight)  
 返回在坐标系中的具体位置

+### Location.GetRect
+
+public Rect GetRect(float graphX, float graphY, float graphWidth, float graphHeight, float rectWidth, float rectHeight)  
+
 ### Location.IsBottom

 public bool IsBottom()  
@@ -9087,6 +9111,11 @@ class in XCharts.Runtime

 UI帮助类。

+### UIHelper.DrawBackground
+
+public static void DrawBackground(VertexHelper vh, Background background, Color32 color, float smoothness = 2)  
+
+
 ## ViewControl

 class in XCharts.Runtime / Inherits from: [ChildComponent](#childcomponent)
--- a/Documentation~/en/changelog.md
+++ b/Documentation~/en/changelog.md
@@ -77,6 +77,31 @@ slug: /changelog

 ## master

+Key Features:
+
+* Added the `UIText` extension component  
+* Added the `UIToggle` extension component  
+* Added the `UISlider` extension component  
+* Refactored the `UIProgress` extension component  
+* Added `borderWidth` and `emptyColor` configurations to `SymbolStyle`  
+* Added the `size2` parameter to `SymbolStyle` to support rectangular markers  
+* Other optimizations and bug fixes  
+
+Detailed Changelog:
+
+* (2025.01.01) Released `v3.13.0`  
+* (2024.12.27) Added the `size2` parameter to `SymbolStyle` to support rectangular markers  
+* (2024.12.26) Optimized `Text` alignment in `TextMeshPro` for proper centering  
+* (2024.12.25) Added support for `{f0}` in the `Tooltip`'s `itemFormatter` setting  
+* (2024.12.25) Fixed an issue where some labels on the `YAxis` might not display during range refresh  
+* (2024.12.23) Added `borderWidth` and `emptyColor` configurations to `SymbolStyle`  
+* (2024.12.17) Added the `UISlider` extension component  
+* (2024.12.10) Added the `UIToggle` extension component  
+* (2024.12.09) Fixed an issue where the `UITable`'s `scrollbar` could not be dragged  
+* (2024.12.07) Fixed an issue where custom nodes could not be placed under the `Chart` node  
+* (2024.12.05) Added the `UIText` extension component  
+* (2024.12.04) Removed the unused `tmpAlignment` option from `TextStyle`  
+
 ## v3.12.1

 Version Highlights:
--- a/Documentation~/en/configuration.md
+++ b/Documentation~/en/configuration.md
@@ -4366,12 +4366,24 @@ class in XCharts.Runtime / Inherits from: [ChildComponent](#childcomponent) / Su

 系列数据项的标记的图形

+### SymbolStyle.borderWidth
+
+`float` `0f` `v3.13.0`
+
+the border width of symbol.
+
 ### SymbolStyle.color

 `Color32`

 图形的颜色。

+### SymbolStyle.emptyColor
+
+`Color32` `v3.13.0`
+
+the color of empty symbol.
+
 ### SymbolStyle.gap

 `float` `0`
@@ -4414,6 +4426,12 @@ Whether the symbol is showed.

 the size of symbol.

+### SymbolStyle.size2
+
+`float` `0f` `v3.13.0`
+
+the size of symbol.
+
 ### SymbolStyle.type

 [SymbolType](#symboltype)
@@ -4551,10 +4569,6 @@ Rotation of text.

 Settings related to text.

-### TextStyle.tMPAlignment
-
-`TextAlignmentOptions`
-
 ### TextStyle.tMPFont

 `TMP_FontAsset`
--- a/Documentation~/zh/api.md
+++ b/Documentation~/zh/api.md
@@ -1362,6 +1362,11 @@ class in XCharts.Runtime / 继承自: [MainComponent](#maincomponent)

 背景组件。

+### Background.rect
+
+public Rect rect  
+背景的矩形区域。
+
 ### Background.SetDefaultValue

 public override void SetDefaultValue()  
@@ -2353,6 +2358,10 @@ class in XCharts.Runtime / 继承自: [MaskableGraphic](https://docs.unity3d.com

 public virtual HideFlags chartHideFlags  

+### BaseGraph.childrenNodeNames
+
+public List&lt;string&gt; childrenNodeNames  
+
 ### BaseGraph.clickPos

 public Vector2 clickPos  
@@ -2411,6 +2420,10 @@ public float graphX
 public float graphY  
 图形的Y

+### BaseGraph.isDragingClick
+
+public bool isDragingClick  
+
 ### BaseGraph.isPointerClick

 public bool isPointerClick  
@@ -2759,6 +2772,10 @@ public float GetRuntimeBorderWidth()

 public float[] GetRuntimeCornerRadius()  

+### BorderStyle.IsCricle
+
+public bool IsCricle()  
+
 ## CalendarCoord

 class in XCharts.Runtime / 继承自: [CoordSystem](#coordsystem),[IUpdateRuntimeData](#iupdateruntimedata),[ISerieContainer](#iseriecontainer)
@@ -2893,7 +2910,8 @@ public static void DestoryGameObject(GameObject go)

 ### ChartHelper.DestoryGameObjectByMatch

-public static void DestoryGameObjectByMatch(Transform parent, string containString)  
+public static void DestoryGameObjectByMatch(Transform parent, List&lt;string&gt; children)  
+

 ### ChartHelper.DestroyAllChildren

@@ -2940,7 +2958,8 @@ public static Vector3 GetLastValue(List&lt;Vector3&gt; list)

 ### ChartHelper.GetMaxCeilRate

-public static double GetMaxCeilRate(double value, double ceilRate)  
+public static float GetMaxCeilRate(float value, float ceilRate)  
+

 ### ChartHelper.GetMaxDivisibleValue

@@ -2952,7 +2971,8 @@ public static double GetMaxLogValue(double value, float logBase, bool isLogBaseE

 ### ChartHelper.GetMinCeilRate

-public static double GetMinCeilRate(double value, double ceilRate)  
+public static float GetMinCeilRate(float value, float ceilRate)  
+

 ### ChartHelper.GetMinDivisibleValue

@@ -5317,6 +5337,10 @@ public float runtimeTop
 public Vector3 GetPosition(float chartWidth, float chartHeight)  
 返回在坐标系中的具体位置

+### Location.GetRect
+
+public Rect GetRect(float graphX, float graphY, float graphWidth, float graphHeight, float rectWidth, float rectHeight)  
+
 ### Location.IsBottom

 public bool IsBottom()  
@@ -9087,6 +9111,11 @@ class in XCharts.Runtime

 UI帮助类。

+### UIHelper.DrawBackground
+
+public static void DrawBackground(VertexHelper vh, Background background, Color32 color, float smoothness = 2)  
+
+
 ## ViewControl

 class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)
--- a/Documentation~/zh/changelog.md
+++ b/Documentation~/zh/changelog.md
@@ -6,6 +6,7 @@ slug: /changelog
 # 更新日志

 [master](#master)  
+[v3.13.0](#v3130)  
 [v3.12.1](#v3121)  
 [v3.12.0](#v3120)  
 [v3.11.2](#v3112)  
@@ -78,6 +79,21 @@ slug: /changelog

 ## master

+## v3.13.0
+
+版本要点：
+
+* 新增`UIText`扩展组件
+* 新增`UIToggle`扩展组件
+* 新增`UISlider`扩展组件
+* 重构`UIProgress`扩展组件
+* 增加`SymbolStyle`的`borderWidth`和`emptyColor`配置
+* 增加`SymbolStyle`的`size2`参数支持长方形标记
+* 其他优化和问题修复
+
+日志详情：
+
+* (2025.01.01) 发布`v3.13.0`版本
 * (2024.12.27) 增加`SymbolStyle`的`size2`参数支持长方形标记
 * (2024.12.26) 优化`Text`在`TextMeshPro`下的居中对齐方式
 * (2024.12.25) 增加`Tooltip`的`itemFormatter`设置`{f0}`支持
--- a/Documentation~/zh/configuration.md
+++ b/Documentation~/zh/configuration.md
@@ -4366,12 +4366,24 @@ class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent) / 子类

 系列数据项的标记的图形

+### SymbolStyle.borderWidth
+
+`float` `0f` `v3.13.0`
+
+图形的边框宽度。
+
 ### SymbolStyle.color

 `Color32`

 图形的颜色。

+### SymbolStyle.emptyColor
+
+`Color32` `v3.13.0`
+
+空心图形的颜色。
+
 ### SymbolStyle.gap

 `float` `0`
@@ -4414,6 +4426,12 @@ class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent) / 子类

 标记的大小。

+### SymbolStyle.size2
+
+`float` `0f` `v3.13.0`
+
+标记的大小。当为Rect时，size2表示高度。
+
 ### SymbolStyle.type

 [SymbolType](#symboltype)
@@ -4551,10 +4569,6 @@ class in XCharts.Runtime / 继承自: [ChildComponent](#childcomponent)

 文本的相关设置。

-### TextStyle.tMPAlignment
-
-`TextAlignmentOptions`
-
 ### TextStyle.tMPFont

 `TMP_FontAsset`