foldcc/XCharts
1
0
Fork 0
mirror of https://github.com/XCharts-Team/XCharts.git synced 2026-05-14 11:40:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

3.15.0

Browse Source
This commit is contained in:
monitor1394
2026-02-27 21:14:53 +08:00
parent 52b9b0a03a
commit 619246bee2
8 changed files with 209 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
Documentation~/en/api.md
View File

@@ -182,6 +182,7 @@ slug: /api
- [ParallelCoordContext](#parallelcoordcontext)
- [Pie](#pie)
- [PieChart](#piechart)
- [PieType](#pietype)
- [PolarAxisTheme](#polaraxistheme)
- [PolarChart](#polarchart)
- [PolarCoord](#polarcoord)
@@ -1723,6 +1724,11 @@ public Dictionary<Type, FieldInfo> typeListForComponent
public Dictionary<Type, FieldInfo> typeListForSerie
### BaseChart.useUtc
public bool useUtc
Whether to use UTC time for the chart.
### BaseChart.AddChartComponent
public MainComponent AddChartComponent(Type type)
@@ -1979,6 +1985,10 @@ public Color32 GetLegendRealShowNameColor(string name)
public int GetLegendRealShowNameIndex(string name)
### BaseChart.GetMainAxis
public Axis GetMainAxis()
### BaseChart.GetMarkColor
public Color32 GetMarkColor(Serie serie, SerieData serieData)
@@ -2626,11 +2636,6 @@ public void RefreshAllComponent()
public virtual void RefreshGraph()
Redraw graph in next frame.
### BaseGraph.SaveAsImage
public void SaveAsImage(string imageType = "png", string savePath = "")
保存图表为图片。
### BaseGraph.ScreenPointToChartPoint
public bool ScreenPointToChartPoint(Vector2 screenPoint, out Vector2 chartPoint)
@@ -2918,11 +2923,11 @@ public static string IntToStr(int value, string numericFormatter = "")
### ChartCached.NumberToDateStr
public static string NumberToDateStr(double timestamp, string formatter)
public static string NumberToDateStr(double timestamp, string formatter, bool local = false)
### ChartCached.NumberToDateTime
public static DateTime NumberToDateTime(double timestamp)
public static DateTime NumberToDateTime(double timestamp, bool local = false)
### ChartCached.NumberToStr
@@ -3168,10 +3173,6 @@ public static void RemoveTMPComponents(GameObject gameObject)
public static Vector3 RotateRound(Vector3 position, Vector3 center, Vector3 axis, float angle)
### ChartHelper.SaveAsImage
public static Texture2D SaveAsImage(RectTransform rectTransform, Canvas canvas, string imageType = "png", string path = "")
### ChartHelper.SetActive
public static bool SetActive(Image image, bool active)
@@ -3844,11 +3845,11 @@ class in XCharts.Runtime
### DateTimeUtil.GetDateTime
public static DateTime GetDateTime(double timestamp, bool local = true)
public static DateTime GetDateTime(double timestamp, bool local = false)
### DateTimeUtil.GetDefaultDateTimeString
public static string GetDefaultDateTimeString(double timestamp, double range = 0)
public static string GetDefaultDateTimeString(double timestamp, double range = 0, bool local = false)
### DateTimeUtil.GetTimestamp
@@ -4764,7 +4765,7 @@ public virtual string GetFormatterContent(int labelIndex, int totalIndex, double
### LabelStyle.GetFormatterDateTime
public string GetFormatterDateTime(int labelIndex, int totalIndex, double value, double minValue, double maxValue)
public string GetFormatterDateTime(int labelIndex, int totalIndex, double value, double minValue, double maxValue, bool local)
### LabelStyle.GetOffset
@@ -6067,10 +6068,6 @@ class in XCharts.Runtime / Inherits from: [MaskableGraphic](https://docs.unity3d
public int index
### Painter.onPopulateMesh
public Action<VertexHelper, Painter> onPopulateMesh
### Painter.type
public Type type
@@ -6205,6 +6202,15 @@ default label pie chart.
public void DefaultRadiusRosePieChart()
default rose pie chart.
## PieType
class in XCharts.Runtime
Options:
- `Solid`: solid pie chart - default fill style.
- `Wireframe`: wireframe pie chart - only show the outline wireframe.
## PolarAxisTheme
class in XCharts.Runtime / Inherits from: [BaseAxisTheme](#baseaxistheme)
@@ -7226,12 +7232,12 @@ public double GetLastData()
### SerieData.GetMaxData
public double GetMaxData(bool inverse = false)
public double GetMaxData(bool inverse = false, int startDimensionIndex = 0)
the maxinum value.
### SerieData.GetMinData
public double GetMinData(bool inverse = false)
public double GetMinData(bool inverse = false, int startDimensionIndex = 0)
the mininum value.
### SerieData.GetMinMaxData

66
Documentation~/en/changelog.md
View File

@@ -6,6 +6,7 @@ slug: /changelog
# Changelog
[master](#master)
[v3.15.0](#v3150)
[v3.14.0](#v3140)
[v3.13.0](#v3130)
[v3.12.1](#v3121)
@@ -79,9 +80,62 @@ slug: /changelog
## master
## v3.15.0
Version Highlights:
* __Enhanced Timeline & Zoom Capabilities__: Added `DataZoom.minZoomRatio` (replacing `minShowNum`), `Chart.useUtc`, and continuous optimization of `Axis Time` performance during zooming and handling of large year ranges.
* __More Flexible Bar Charts & Axis Configuration__: Added `Axis.mainAxis` to control bar chart orientation, `Serie.ignoreZeroOccupy` to control whether zero-value bars occupy space, and `AxisLine` extension line configurations.
* __Improved Chart Styling & Interactivity__: Added `Pie.pieType`, `Legend.itemInactiveOpacity`, `Axis.onLabelClick`, `Animation.Exchange`, `LabelStyle.fixedX/fixedY`, and more.
* __Ongoing Enhancement of Extended UI Components__: Added `Title` and `Viewport` configurations for `UITable`, enhanced `UIStatistic.desc`, and optimized `Comment.layer` and coordinate refresh experience.
* __Focused Stability & Compatibility Fixes__: Resolved critical issues including `SaveAsImage` being blocked by other components, `Pie` click failures, `TMP` compatibility, `Gantt` time range and year 2038 problem, `MarkArea/GridCoord/Axis` and more.
Changelog Details:
* (2026.03.01) Released version `v3.15.0`
* (2026.02.26) Added `ignoreZeroOccupy` to `Serie` to set whether zero-value Bars occupy space (#286)
* (2026.02.26) Fixed `SaveAsImage` not saving correctly when blocked by other components (#337)
* (2026.02.26) Added `mainAxis` parameter to `Axis` to set the main axis for controlling bar chart orientation (#331)
* (2026.02.03) Fixed `UITable` `viewport` potentially drawing incorrectly under different anchor points
* (2026.01.15) Fixed `Pie` click sometimes not responding (#357)
* (2026.01.08) Added `minZoomRatio` to `DataZoom` to replace the old `minShowNum` (#350)
* (2025.11.05) Fixed `Axis` `indicatorLabel` not being hideable
* (2025.11.03) Added `Tooltip` `Title` time formatting via `TitleLabelStyle` `numericFormatter` (#353)
* (2025.10.30) Added `useUtc` parameter to `Chart` to set whether displayed time uses UTC
* (2025.10.30) Optimized `Candlestick` support for time axis
* (2025.10.30) Added support for `ignore` in `Scatter` to skip data points
* (2025.10.24) Optimized line drawing order for `Sankey`
* (2025.10.22) Added `pieType` to `Pie` supporting solid pie charts and wireframe handle charts (#349)
* (2025.09.05) Optimized `MarkLine` performance
* (2025.09.01) Added `startExtendLength` and `endExtendLength` to `AxisLine` for setting axis line extensions
* (2025.08.27) Fixed `Serie` `TitleStyle` not refreshing promptly when data changed
* (2025.05.19) Fixed `Axis` runtime error when `TMP` is enabled
* (2025.04.25) Fixed `MarkArea` drawing inaccurately when specifying `yValue` or `xValue`
* (2025.04.17) Added `Title` support for `UITable` to set headers
* (2025.04.17) Added `Viewport` support for `UITable` to set table viewport margins and borders
* (2025.04.15) Added `Bar` support for color settings via `VisualMap`
* (2025.04.14) Added `showZeroLabel` to `AxisLabel` to set whether to display zero tick
* (2025.04.08) Added `desc` description text setting support for `UIStatistic`
* (2025.04.07) Fixed `Gantt` chart calculating inaccurate time ranges with multi-dimensional data
* (2025.04.07) Optimized `Axis` `Time` axis support for Custom and ceilRate settings
* (2025.04.07) Fixed `GridCoord` covering charts when background color set and Serie Clip enabled
* (2025.04.07) Fixed `Gantt` chart display errors when year exceeds 2038
* (2025.04.07) Fixed `Axis` `Time` axis not displaying years beyond 2038
* (2025.04.06) Fixed `Axis` `Time` axis text display errors when zoomed with `DataZoom`
* (2025.03.28) Fixed `Pie3D` `avoidLabelOverlap` not working
* (2025.03.27) Added `itemInactiveOpacity` to `Legend` to set color transparency for inactive states (#343)
* (2025.03.27) Added `onLabelClick` callback event to `Axis`
* (2025.03.26) Added `Exchange` sort swap animation to `Animation`
* (2025.03.22) Added `layer` setting to `Comment`
* (2025.03.21) Optimized coordinate refresh for `Comment`
* (2025.03.19) Added `{index}` wildcard support for `Serie` `Label` `formatter`
* (2025.03.18) Added `TitleStyle` component support for `Bar`
* (2025.03.18) Added `fixedX` and `fixedY` to `LabelStyle` to fix label coordinates
* (2025.03.17) Added `backgroundGap` to `ItemStyle` to set data item background gap
## v3.14.0
**Key Highlights:**
Version Highlights:
* Added real-time sorting functionality for `Bar`
* Added support for `\n` line breaks in `itemFormatter` for `Tooltip`
@@ -89,7 +143,7 @@ slug: /changelog
* Added `speed` to `Animation` to specify animation speed
* Optimized column alignment in `Tooltip`
**Detailed Changelog:**
Changelog Details:
* (2025.03.15) Released version `v3.14.0`
* (2025.03.09) Fixed an issue where `Bar` displayed abnormally when placed in different `Grids` within the same `Chart`
@@ -111,7 +165,7 @@ slug: /changelog
## v3.13.0
Key Features:
Version Highlights:
* Added the `UIText` extension component
* Added the `UIToggle` extension component
@@ -121,7 +175,7 @@ Key Features:
* Added the `size2` parameter to `SymbolStyle` to support rectangular markers
* Other optimizations and bug fixes
Detailed Changelog:
Changelog Details:
* (2025.01.01) Released `v3.13.0`
* (2024.12.27) Added the `size2` parameter to `SymbolStyle` to support rectangular markers
@@ -168,7 +222,7 @@ Version Highlights:
* Adjusted and perfected the documentation
* Other optimizations and fixes
Log Details:
Changelog Details:
* (2024.09.30) Released version `v3.12.0`
* (2024.09.27) Improved the `5-minute tutorial`
@@ -201,7 +255,7 @@ Log Details:
## v3.11.0
Release Highlights:
Version Highlights:
* Added `Line3DChart` for 3D line charts
* Added `GraphChart` for relationship graphs

45
Documentation~/en/configuration.md
View File

@@ -618,6 +618,12 @@ Base of logarithm, which is valid only for numeric axes with type: 'Log'.
On the log axis, if base e is the natural number, and is true, logBase fails.
### Axis.mainAxis
`bool` `false` `v3.15.0`
Whether it is the main axis. When both X and Y axes are of the same type, the axis set to main axis will determine the orientation, such as horizontal bar chart and vertical bar chart.
### Axis.max
`double`
@@ -828,6 +834,12 @@ Settings related to axis line.
the arrow of line.
### AxisLine.endExtendLength
`float`
Extend length of the axis line at the end.
### AxisLine.onZero
`bool`
@@ -840,6 +852,12 @@ When mutiple axes exists, this option can be used to specify which axis can be "
Whether to show the arrow symbol of axis.
### AxisLine.startExtendLength
`float`
Extend length of the axis line at the start.
## AxisMinorSplitLine
class in XCharts.Runtime / Inherits from: [BaseLine](#baseline)
@@ -1504,11 +1522,11 @@ Distance between dataZoom component and the left side of the container. left val
选取框样式。
### DataZoom.minShowNum
### DataZoom.minZoomRatio
`int` `2`
`float` `0.2f`
Minimum number of display data. Minimum number of data displayed when DataZoom is enlarged to maximum.
The minimum zoom ratio of dataZoom. Range 0f-1f.
### DataZoom.orient
@@ -3361,6 +3379,17 @@ Distance between grid component and the top side of the container.
class in XCharts.Runtime / Inherits from: [Serie](#serie)
### Pie.pieType
[PieType](#pietype) `v3.15.0`
Pie chart type.
Options:
- `Solid`: solid pie chart - default fill style.
- `Wireframe`: wireframe pie chart - only show the outline wireframe.
### Pie.radiusGradient
`bool` `false` `v3.8.1`
@@ -3529,13 +3558,13 @@ The width of the bar. Adaptive when default 0.
`float` `2f`
斑马线的间距。
The gap of zebra bar. It is the distance between two zebra stripes. When the value is 0, there is no gap between stripes.
### Serie.barZebraWidth
`float` `4f`
斑马线的粗细。
The width of zebra bar. It is the width of each zebra stripe. When the value is 0, there is no zebra stripe.
### Serie.bottom
@@ -3639,6 +3668,12 @@ Index of layout component that serie uses. Default is -1 means not use layout, o
忽略数据的默认值。当ignore为true才有效。
### Serie.ignoreZeroOccupy
`bool` `false` `v3.15.0`
Whether to ignore the zero value bar occupy. When enabled, the bar with zero value will not occupy space, and the gap between bars will be automatically adjusted according to the actual displayed bars. Generally used in bar chart.
### Serie.index
`int`

46
Documentation~/zh/api.md
View File

@@ -182,6 +182,7 @@ slug: /api
- [ParallelCoordContext](#parallelcoordcontext)
- [Pie](#pie)
- [PieChart](#piechart)
- [PieType](#pietype)
- [PolarAxisTheme](#polaraxistheme)
- [PolarChart](#polarchart)
- [PolarCoord](#polarcoord)
@@ -1723,6 +1724,11 @@ public Dictionary<Type, FieldInfo> typeListForComponent
public Dictionary<Type, FieldInfo> typeListForSerie
### BaseChart.useUtc
public bool useUtc
图表的时间是否都显示为UTC时间。
### BaseChart.AddChartComponent
public MainComponent AddChartComponent(Type type)
@@ -1979,6 +1985,10 @@ public Color32 GetLegendRealShowNameColor(string name)
public int GetLegendRealShowNameIndex(string name)
### BaseChart.GetMainAxis
public Axis GetMainAxis()
### BaseChart.GetMarkColor
public Color32 GetMarkColor(Serie serie, SerieData serieData)
@@ -2626,11 +2636,6 @@ public void RefreshAllComponent()
public virtual void RefreshGraph()
在下一帧刷新图形。
### BaseGraph.SaveAsImage
public void SaveAsImage(string imageType = "png", string savePath = "")
保存图表为图片。
### BaseGraph.ScreenPointToChartPoint
public bool ScreenPointToChartPoint(Vector2 screenPoint, out Vector2 chartPoint)
@@ -2918,11 +2923,11 @@ public static string IntToStr(int value, string numericFormatter = "")
### ChartCached.NumberToDateStr
public static string NumberToDateStr(double timestamp, string formatter)
public static string NumberToDateStr(double timestamp, string formatter, bool local = false)
### ChartCached.NumberToDateTime
public static DateTime NumberToDateTime(double timestamp)
public static DateTime NumberToDateTime(double timestamp, bool local = false)
### ChartCached.NumberToStr
@@ -3168,10 +3173,6 @@ public static void RemoveTMPComponents(GameObject gameObject)
public static Vector3 RotateRound(Vector3 position, Vector3 center, Vector3 axis, float angle)
### ChartHelper.SaveAsImage
public static Texture2D SaveAsImage(RectTransform rectTransform, Canvas canvas, string imageType = "png", string path = "")
### ChartHelper.SetActive
public static bool SetActive(Image image, bool active)
@@ -3844,11 +3845,11 @@ class in XCharts.Runtime
### DateTimeUtil.GetDateTime
public static DateTime GetDateTime(double timestamp, bool local = true)
public static DateTime GetDateTime(double timestamp, bool local = false)
### DateTimeUtil.GetDefaultDateTimeString
public static string GetDefaultDateTimeString(double timestamp, double range = 0)
public static string GetDefaultDateTimeString(double timestamp, double range = 0, bool local = false)
### DateTimeUtil.GetTimestamp
@@ -4764,7 +4765,7 @@ public virtual string GetFormatterContent(int labelIndex, int totalIndex, double
### LabelStyle.GetFormatterDateTime
public string GetFormatterDateTime(int labelIndex, int totalIndex, double value, double minValue, double maxValue)
public string GetFormatterDateTime(int labelIndex, int totalIndex, double value, double minValue, double maxValue, bool local)
### LabelStyle.GetOffset
@@ -6067,10 +6068,6 @@ class in XCharts.Runtime / 继承自: [MaskableGraphic](https://docs.unity3d.com
public int index
### Painter.onPopulateMesh
public Action<VertexHelper, Painter> onPopulateMesh
### Painter.type
public Type type
@@ -6205,6 +6202,15 @@ public void DefaultLabelPieChart()
public void DefaultRadiusRosePieChart()
默认玫瑰饼图。
## PieType
class in XCharts.Runtime
可选：
- `Solid`: 实心饼图 - 默认填充样式
- `Wireframe`: 线框饼图 - 仅显示轮廓线框
## PolarAxisTheme
class in XCharts.Runtime / 继承自: [BaseAxisTheme](#baseaxistheme)
@@ -7226,12 +7232,12 @@ public double GetLastData()
### SerieData.GetMaxData
public double GetMaxData(bool inverse = false)
public double GetMaxData(bool inverse = false, int startDimensionIndex = 0)
最大值。
### SerieData.GetMinData
public double GetMinData(bool inverse = false)
public double GetMinData(bool inverse = false, int startDimensionIndex = 0)
最小值。
### SerieData.GetMinMaxData

14
Documentation~/zh/changelog.md
View File

@@ -6,6 +6,7 @@ slug: /changelog
# 更新日志
[master](#master)
[v3.15.0](#v3150)
[v3.14.0](#v3140)
[v3.13.0](#v3130)
[v3.12.1](#v3121)
@@ -80,6 +81,19 @@ slug: /changelog
## master
## v3.15.0
版本要点：
* __时间轴与缩放能力增强__：新增 `DataZoom.minZoomRatio`（替代 `minShowNum`）、`Chart.useUtc`，并持续优化 `Axis Time` 在缩放与大年份场景下的表现。
* __柱图与坐标轴配置更灵活__：新增 `Axis.mainAxis` 控制柱图朝向、`Serie.ignoreZeroOccupy` 控制 0 值柱是否占位、`AxisLine` 延长线配置等。
* __图表样式与交互能力提升__：新增 `Pie.pieType`、`Legend.itemInactiveOpacity`、`Axis.onLabelClick`、`Animation.Exchange`、`LabelStyle.fixedX/fixedY` 等。
* __扩展 UI 组件持续完善__：`UITable` 新增 `Title` 与 `Viewport` 配置，`UIStatistic.desc` 增强，`Comment.layer` 与坐标刷新体验优化。
* __稳定性与兼容性修复集中推进__：修复 `SaveAsImage` 遮挡保存、`Pie` 点击失效、`TMP` 兼容、`Gantt` 时间区间与 2038 年问题、`MarkArea/GridCoord/Axis` 等多项关键问题。
日志详情：
* (2026.03.01) 发布`v3.15.0`版本
* (2026.02.26) 增加`Serie`的`ignoreZeroOccupy`可设置0数据的Bar是否占位 (#286)
* (2026.02.26) 修复`SaveAsImage`被其他组件遮挡时无法正常保存的问题 (#337)
* (2026.02.26) 增加`Axis`的`mainAxis`参数设置主轴可控制柱图的朝向 (#331)

41
Documentation~/zh/configuration.md
View File

@@ -618,6 +618,12 @@ class in XCharts.Runtime / 继承自: [MainComponent](#maincomponent) / 子类:
对数轴是否以自然数 e 为底数，为 true 时 logBase 失效。
### Axis.mainAxis
`bool` `false` `v3.15.0`
是否为主轴。当XY轴类型都相同时，设置为主轴的轴会决定朝向，如横向柱图和纵向柱图。
### Axis.max
`double`
@@ -828,6 +834,12 @@ class in XCharts.Runtime / 继承自: [BaseLine](#baseline)
轴线箭头。
### AxisLine.endExtendLength
`float`
轴线终点延长线长度。
### AxisLine.onZero
`bool`
@@ -840,6 +852,12 @@ X 轴或者 Y 轴的轴线是否在另一个轴的 0 刻度上，只有在另一
是否显示箭头。
### AxisLine.startExtendLength
`float`
轴线起点延长线长度。
## AxisMinorSplitLine
class in XCharts.Runtime / 继承自: [BaseLine](#baseline)
@@ -1504,11 +1522,11 @@ DataZoom 组件 用于区域缩放，从而能自由关注细节的数据信息
选取框样式。
### DataZoom.minShowNum
### DataZoom.minZoomRatio
`int` `2`
`float` `0.2f`
最小显示数据个数。当DataZoom放大到最大时，最小显示的数据个数。
缩放区域组件的最小缩放比例，范围0f-1f。
### DataZoom.orient
@@ -3361,6 +3379,17 @@ grid 组件离容器上侧的距离。
class in XCharts.Runtime / 继承自: [Serie](#serie)
### Pie.pieType
[PieType](#pietype) `v3.15.0`
饼图类型。
可选：
- `Solid`: 实心饼图 - 默认填充样式
- `Wireframe`: 线框饼图 - 仅显示轮廓线框
### Pie.radiusGradient
`bool` `false` `v3.8.1`
@@ -3639,6 +3668,12 @@ class in XCharts.Runtime / 继承自: [BaseSerie](#baseserie), [IComparable](htt
忽略数据的默认值。当ignore为true才有效。
### Serie.ignoreZeroOccupy
`bool` `false` `v3.15.0`
柱图是否忽略值为0的柱子占位。开启后，值为0的柱子将不会占用空间，柱子之间的间距会根据实际显示的柱子自动调整。一般用在柱状图中。
### Serie.index
`int`

4
Runtime/Internal/XChartsMgr.cs
View File

@@ -21,8 +21,8 @@ namespace XCharts.Runtime
[ExecuteInEditMode]
public static class XChartsMgr
{
public static readonly string version = "3.14.0";
public static readonly int versionDate = 20250315;
public static readonly string version = "3.15.0";
public static readonly int versionDate = 20260301;
public static string fullVersion { get { return version + "-" + versionDate; } }
internal static List<BaseChart> chartList = new List<BaseChart>();

6
package.json
View File

@@ -3,9 +3,9 @@
"displayName": "XCharts",
"author": "monitor1394",
"license": "MIT",
"version": "3.14.0",
"date": "20250315",
"checkdate": "20250315",
"version": "3.15.0",
"date": "20260301",
"checkdate": "20260301",
"unity": "2018.3",
"description": "A charting and data visualization library for Unity. Support line chart, bar chart, pie chart, radar chart, scatter chart, heatmap chart, ring chart, candlestick chart, polar chart and parallel coordinates.",
"keywords": [