XCharts 版本演进全解读:从 v0.1.0 到 v3.15.0 的功能变迁与源码实现

原创2026-10-13 09:07:361,677 阅读
文章标签:图表库数据可视化UI组件游戏开发

XCharts 版本演进全解读:从 v0.1.0 到 v3.15.0 的功能变迁与源码实现

XCharts 是面向 Unity 的开源数据可视化图表插件,其官方 Changelog 记录了从 v0.1.0(2018 年)到 v3.15.0(2026 年)的完整演进历史。本文以该文档为主体,结合仓库源码(Runtime/ 目录)与配置示例,按版本脉络系统梳理 XCharts 的核心能力扩展、重要 API 调整与升级注意事项,帮助你快速理解各版本差异、定位所需特性,并在升级或二次开发时准确判断某个参数、接口的引入时机与底层实现。

版本脉络总览与 Changelog 阅读方法

Documentation~/en/changelog.md 以倒序方式维护了自项目诞生以来的全部发布记录,目录结构如下:

  • 未发布的开发中内容归入 master 段;
  • 已发布版本从最新 v3.15.0 一直回溯到最初 v0.1.0;
  • 每个版本条目通常包含 Version Highlights(版本亮点)、Extension features(扩展特性)、Changelog Details(逐条变更)与 Upgrade Note(升级提示)。

版本号命名遵循语义化规则:v3.x.y 为当前 3.x 主线,v2.x.y、v1.x.y 为历史主线,另有 v3.0.0-previewN 等预览版本。当前仓库 package.json 中记录的版本为 3.15.0,unity 字段为 2018.3,即最低支持的 Unity 版本。

从功能演进看,XCharts 大致经历了四个阶段:

  • v0.x(2018–2019):基础图表能力从无到有,LineChart、BarChart、PieChart、RadarChart、ScatterChart、HeatmapChart 相继落地;
  • v1.x(2019–2020):编辑器能力、动画、主题、Tooltip、DataZoom 等组件体系成型;
  • v2.x(2021):数据结构升级到 double、新增 MarkLine、完善 DataZoom 与交互回调;
  • v3.x(2022–2026):底层框架重构、多坐标系与 3D 支持、时间轴(Time axis)、UI 扩展组件(UITable 等)与大规模性能优化。

下文按版本分组展开,每个版本的重点条目均可在 Runtime/ 源码与 configuration.md 中找到对应配置说明。

v3.15.0:时间轴、柱状图灵活性与交互增强

v3.15.0(2026.03.01 发布)是当前仓库的最新版本,核心亮点集中在时间轴缩放、柱状图朝向控制、图表样式与交互回调四个方面。

缩放与时间轴:minZoomRatio、useUtc 与 Time 轴优化

  • DataZoom.minZoomRatio(替代 minShowNum):以比例(0f–1f)控制缩放窗口的最小范围,取代旧的"最小显示数据个数"语义。源码中 minShowNum 已被标记为 <a href="https://link.gitcode.com/i/3f0e5c86e3e2e71056d35ac9d905ed3e" target="_blank">Obsolete("Use \"minZoomRatio\" instead", true)](见 [Runtime/Component/DataZoom/DataZoom.cs)。实际生效逻辑位于 Runtime/Component/DataZoom/DataZoomContext.cs 与 Runtime/Serie/SerieHelper.cs:类目轴按 data.Count * minZoomRatio 计算最小显示数量,数值轴按 (max - min) * minZoomRatio 计算最小范围,且当比例大于数据总数时会自动兜底为全部数据。注意 DataZoomHandler.cs 中框选(Marquee)区域不受 minZoomRatio 限制,因为用户显式指定了缩放区域。
  • Chart.useUtc:控制时间轴显示与解析是否使用 UTC 时间。该属性定义在 Runtime/Internal/BaseChart.API.cs,并在 AxisHandler.cs、TooltipHandler.cs 等位置通过 !chart.useUtc 传入 DateTimeUtil 决定按本地时间还是 UTC 转换。默认 false 即使用本地时间,对跨时区数据展示或后端统一 UTC 存储的场景建议显式开启。
  • Time 轴持续优化:本版本修复了 DataZoom 缩放时 Time 轴文本显示错误、2038 年之后年份显示异常、Custom 与 ceilRate 设置下 Time 轴支持等问题,并优化了 Candlestick 对时间轴的支持。这些改动集中在 AxisHelper.cs 的标签格式化与分段逻辑中。

柱状图与坐标轴:mainAxis、ignoreZeroOccupy、AxisLine 延伸

  • Axis.mainAxis:当 X/Y 轴类型相同时,通过将其中一个轴设置为主轴来决定图表朝向(横向柱图与纵向柱图)。源码注释明确说明"当 XY 轴类型都相同时,设置为主轴的轴会决定朝向"(Runtime/Component/Axis/Axis.cs),该参数自 v3.15.0 引入,配合 BaseChart.Component.cs 的 GetMainAxis() 逻辑使用。
  • Serie.ignoreZeroOccupy:控制值为 0 的柱是否占用空间。相关实现见 Runtime/Serie/Bar/BarHandler.cs:开启后 0 值柱不参与布局占位,避免出现空白柱体。
  • AxisLine.startExtendLength / endExtendLength:设置坐标轴线的起点/终点延伸长度(Runtime/Component/Axis/AxisLine.cs),在 AxisHandler.cs 中参与轴线绘制。

样式与交互:pieType、itemInactiveOpacity、onLabelClick、Exchange

此外本版本还引入了 Serie 的 {index} 通配符(Label formatter 中可用)、Bar 的 TitleStyle 组件、AxisLabel.showZeroLabel(是否显示 0 刻度标签)、VisualMap 控制 Bar 配色、Legend 与 Tooltip 的若干格式与对齐修复、Scatter 的 ignore 数据点跳过、Sankey 线绘制顺序优化等。

扩展 UI 组件:UITable、UIStatistic 与 Comment

  • UITable 新增 Title(表头)与 Viewport(视口边距与边框)配置;
  • UIStatistic 新增 desc 描述文本设置;
  • Comment 新增 layer 层级设置(CommentLayer 枚举,见 Runtime/Component/Comment/Comment.cs),并优化了坐标刷新体验,对应绘制层逻辑见 CommentHander.cs。

稳定性修复盘点

本版本修复了多个影响实际使用的关键问题:SaveAsImage 被其他组件遮挡时保存异常(#337)、Pie 点击偶发无响应(#357)、TMP 开启时 Axis 运行时错误、Gantt 多维数据时间范围计算不准确与 2038 年问题、MarkArea 指定 yValue/xValue 时绘制不精确、GridCoord 背景色与 Clip 组合时遮挡图表等。

v3.14.0:实时排序、Tooltip 增强与格式化扩展

v3.14.0(2025.03.15 发布)的核心是交互与格式化能力:

  • Bar.realtimeSort:柱状图实时排序,Bar 类通过 useSortData => realtimeSort 接入排序数据管线(Runtime/Serie/Bar/Bar.cs),Tooltip 与 Label 通过 sortedDataIndices/sortIndex 取到排序后的正确数据(TooltipHandler.cs)。
  • Animation.speed:直接指定动画速度,替代/补充按时长配置。
  • Tooltip.columnGapWidths:设置列文本之间的间距列表(Runtime/Component/Tooltip/Tooltip.cs),由 TooltipView.cs 按列索引取值。
  • 格式化通配符扩展:Axis 的 Label formatter 支持 {index}、{index-1}、{-index}、{-index-1};AxisLabel 支持 {index};Tooltip.itemFormatter 支持 \n 换行。
  • 其他:SaveAsImage 支持透明背景保存(#337)、GraphChart 支持按 data 单独设置样式、SerieSymbol.sizeFunction 重构、修复同 Chart 内不同 Grid 下 Bar 显示异常、运行时动态添加 Component 导致异常(#339)、TMP 关闭时残留组件影响 Text 初始化等问题。

v3.13.0:UI 扩展组件批量加入

v3.13.0(2025.01.01 发布)围绕 UI 扩展组件与标记样式:

  • 新增扩展组件:UIText、UIToggle、UISlider,并重构 UIProgress;修复 UITable 的 scrollbar 无法拖动的问题。
  • SymbolStyle.size2:新增宽高参数,支持矩形标记(size2 作为高度,见 Runtime/Component/Child/SymbolStyle.cs)。
  • SymbolStyle.borderWidth / emptyColor:新增边框宽度与空心标记的内部颜色配置(Runtime/Component/Child/SymbolStyle.cs),配合 DrawSymbol 系列绘制接口使用(Runtime/Internal/BaseChart.Draw.cs)。
  • 其他:Tooltip.itemFormatter 支持 {f0} 数值格式;修复 TextMeshPro 文本居中、YAxis 区间刷新时部分标签不显示等问题;移除 TextStyle 中无用的 tmpAlignment 选项。

v3.12.x:Ring 渐变、numericFormatter 时间格式与性能优化

v3.12.0

  • Ring.radiusGradient:设置环形图半径方向渐变(自 v3.8.1 起 Pie 已支持 radiusGradient,本版本补全 Ring)。
  • numericFormatter 支持 date 与 time:数值格式化器可直接输出日期/时间文本。
  • AreaStyle.origin:完善区域填充起点位置的定义,控制面积图渐变是从顶部开始还是从实际数据位置开始(该主题最早可追溯到 v3.4.0 之前的 toTop 参数,本版本进一步规范化)。
  • 优化了 Time 轴首个 Label 的位置、Legend 多 Series 的 formatter 支持(#332),并改进了 5 分钟教程文档(见 tutorial01.md)。

v3.12.1

  • 优化折线图在数据点密集时的渲染性能(Line 密集点绘制优化);
  • 修复移动端设置其他锚点时 Tooltip 显示错误、Tooltip 可能超出屏幕、动态修改 Time 时间轴在动画开启时效果异常、代码中无法开启 Animation(#334)、动态修改 DataZoom 的 start/end 不刷新、Title 设置隐藏后仍可见等问题;
  • 清理 Unity6 下的部分代码警告,并完善中英文官网文档。

v3.11.x:3D 图表、关系图与交互回调体系

v3.11.0(2024.06.16 发布)

  • 新增 Line3DChart(3D 折线图)与 GraphChart(关系图),并引入 3D 坐标系支持(GridCoord3D 相关实现见 Runtime/Coord/Grid3D/,类目轴自本版本起支持 3D 坐标系)。
  • Tooltip.triggerOn:定义触发条件;同时将旧 Corss 更名为 Cross。
  • Axis.minCategorySpacing:设置类目轴默认最小类目间距。
  • 编辑器增强:右键菜单从 XCharts 调整为 UI/XCharts;数据列表支持上移/下移/增删按钮。
  • 新增工具类 JsonUtil(Runtime/Utilities/JsonUtil.cs),用于序列化/反序列化辅助。
  • 修复 Tooltip 每帧 GC 问题(#311)、多次调用 ConvertXYAxis() 后图表异常、DataZoom 控制多轴时 GridCoord 获取可能错误(#317)、Pie 的 ItemStyle 设置 opacity 颜色异常(#309)等。

v3.11.1 / v3.11.2

  • 修复 Serie 多颜色异常、初始化时 labels 堆积问题;
  • 修复微信小游戏平台 Tooltip 报错(#326)、动态创建图表时背景不自适应(#323)、DataZoom 开启时 Tooltip 指示内容不准确、MarkLine 的 Label 初始化时闪烁等问题;
  • 优化 Time 轴下 Tooltip 的默认效果、分割与移动性能,以及 Pie 触发 Tooltip 时 Label 的行为。

v3.10.x:双类目轴、快捷菜单与图表边框

  • v3.10.0:新增双类目轴支持(Bar、Line 均可让 X/Y 轴同时为 Category 轴);新增大量一键创建图表的快捷菜单;新增 BorderStyle 边框样式与 Background.borderStyle(默认圆角),支持圆角图表;扩展特性新增 SankeyChart 桑基图(Serie 的 Link 用于添加节点边关系)与 UITable 的 border 设置。还新增 Serie.minShowLabel(隐藏小于指定值的 label)、LevelStyle 的 depth 与 LineStyle、DataZoom 的 MarqueeStyle 框选区域、ResetChartStatus() 主动重置接口、Legend 的 TextLimit 文本长度限制、Heatmap 的 maxCache 等。
  • v3.10.1:修复 Tooltip 圆点标记不随颜色适配。
  • v3.10.2:修复 Legend formatter 设置 {d} 时的错配(#304)、Tooltip 移出坐标系后仍显示、旧版本升级后 Tooltip 标题不显示等问题。

v3.9.0:Axis 动画、对数轴次刻度与顶层 MarkLine

  • Axis 支持动画(Animation):提升数据更新时的过渡效果;SerieData 可单独添加 Label。
  • Axis 的 Log 类型支持 minorTick(次刻度),即对数轴次刻度。
  • MarkLine.onTop:控制标记线是否绘制在顶层。
  • UITable 新增轮播(carousel)功能、数据 API 与回调;Pie3DChart 优化渲染性能。
  • 修复 Tooltip 的 titleFormatter 设置 {b} 显示不准、Chart.UpdateData() 返回值不准、Legend formatter 随数据变化自动刷新、SerieEventData 的 value 恒为 0(#287)、Bar 渐变下鼠标移动异常(#285)、Pie 0 数据时 Label 位置异常、Line 设置 AlongPath 动画异常(#281)等问题。

v3.8.x:动画系统重构、新 Symbol 与 GridLayout

v3.8.0(2023.09.03 发布)

  • 重构 Animation 动画系统:新增 New Animation(Addition)与 Interactive animation(Interaction)配置,改善 PieChart 的交互动画表现(相关类型见 Runtime/Component/Animation/AnimationInfo.cs 与 AnimationStyle.cs 中列出的 FadeIn/FadeOut/Change/Addition/Interaction/Exchange 六种动画)。
  • Symbol 新增四种标记:EmptyTriangle、EmptyDiamond、Plus、Minus(绘制见 ChartDrawer.cs)。
  • 新增 GridLayout 网格布局组件:用于管理多个 GridCoord 的布局(Runtime/Coord/Grid/XGridLayout.cs);Pie、Ring、Radar 均支持 gridIndex 指定所属网格。
  • Tooltip 新增 Auto 类型:自动设置显示类型与触发类型。
  • LabelLine.lineEndX:设置引导线固定 X 位置,Pie 与 Ring 均支持。
  • 图表鼠标交互回调增强:onSerieEnter、onSerieExit、onSerieClick 等全面生效。
  • 新增 XLog 日志系统(Runtime/XLog/XLog.cs)与 MLValue 多值类型、Serie.minRadius、Axis 的 IconStyle 动态图标颜色(color 设为 clear)等。
  • 修复 YAxis 全 0 数据时默认 0–1 范围、DataZoom 开启时无法添加数据、itemFormatter 在 SerieData 单独设置 ItemStyle 时不生效、运行时删除 Chart 报错(#269)、TextMeshPro 与 NewInputSystem 开启后更新报错(#272)等。

v3.8.1

  • Pie.radiusGradient 支持半径方向渐变;Line 平滑曲线支持虚线;修复 Bar 横向设置 Bottom 不生效、类目轴无数据时 Tooltip 异常(#279)、Pie 无数据绘制异常(#278)、TriggerTooltip() 对 Ring 无效、Radar 数据全 0 绘制错误等问题。

v3.7.0 与 v3.6.0:帮助文档、Clip 与输入系统支持

  • v3.7.0:新增 HelpDoc 官网帮助文档跳转;Line 支持 Clip 裁剪;Axis 新增 MinMaxAuto 范围类型;新增 BaseChart.TriggerTooltip() 接口;Symbol 选择 Custom 类型时给出警告;修复 Theme 修改默认参数后被重置、DataZoom 多图表异常(#252)、Legend 因 Serie 名含 _ 不触发(#252)等问题。
  • v3.6.0:新增 LabelStyle.autoRotate(倾斜竖排文本自动旋转)、Legend 自定义 Positions、DataZoom.startLock/endLock 与 startEndFunction 委托、VR 等非鼠标输入支持(#248);新增 onSerieClick/onSerieDown/onSerieEnter/onSerieExit 回调;重构 Component 代码并调整 API;AreaStyle.toTop 参数(折线渐变到顶部或实际位置);formatter 新增 {h} 通配符(当前颜色值);支持 InputSystem(#242);Covert 全部更名 Convert(涉及 ConvertXYAxis()、CovertSerie() 等接口)。

v3.5.0:文档重构与 DataZoom 框选

  • 更新文档结构,新增官方主页;升级提示:因目录结构调整,建议升级前备份并删除原 XCharts 目录。
  • Serie.barMaxWidth 设置 Bar 最大宽度;DataZoom.MarqueeStyle 支持框选区域;Pie 的 LabelLine 支持 Symbol;Radar 的 Single 类型优化面积填充;Tooltip 阴影保持在图表范围内;接口更名:UdpateXAxisIcon() → UpdateXAxisIcon()(#235)。

v3.4.0:数值轴缩放与平滑曲线控制

  • DataZoom 支持数值轴(此前仅类目轴);Axis 新增 indicatorLabel(指示文本样式,替代 Tooltip 的 indicatorLabelStyle,#226);Serie.markColor 设置图例/Tooltip 显示用的标记颜色(#229);RadarCoord.startAngle 设置雷达起始角;Line.SmoothLimit 控制平滑曲线效果;Animation 支持 UnscaledTime(不受 TimeScale 影响,#223)。
  • 新增 API:AddData()、ClearSerieData()、ClearComponentData();修复 Download 接口导致 iOS 打包失败、图表过小导致 DivideByZeroException(#230)等问题。

v3.3.0:PolarChart 扩展与 Heatmap 类型

  • PolarChart 支持 Bar(多柱/堆叠)与 Heatmap;PolarCoord 可通过 Radius 设置环形极坐标。
  • 新增 HeatmapChart 类型,heatmapType 支持 Data/Count 两种映射方式,symbol 支持不同图案。
  • 新增 SaveAsImage() 接口(将图表保存为图片,后续版本持续修复其被遮挡/透明问题);RingChart 支持 LabelLine;SerieSymbol 新增 minSize/maxSize;AxisSplitLine 新增 showStartLine/showEndLine;Legend 新增 Candlestick 图标类型;formatter 支持 {d3} 维度数据百分比;Tooltip 的 position 支持不同显示位置;移除 Tooltip 的 fixedXEnable/fixedYEnable 参数(相关能力由 Tooltip.fixedX/fixedY 提供,见 Runtime/Component/Tooltip/Tooltip.cs)。

v3.2.0:状态样式、次刻度与时间轴

  • Serie 支持三态样式:EmphasisStyle(强调)、BlurStyle(模糊)、SelectStyle(选中),并移除旧的 Emphasis/EmphasisItemStyle/EmphasisLabelStyle/EmphasisLabelLine 组件与 highlightColor 等参数(对应实现见 Runtime/Component/State/)。
  • Axis 支持次刻度与次分割线:MinorTick 与 MinorSplitLine;Axis 支持 Time 时间轴及其次刻度/次分割。
  • Serie.colorBy:不同颜色选取策略;Radar.smooth 平滑曲线;AreaStyle.innerFill 凸多边形填充;DataZoom 支持时间轴;Serie/SerieData 默认状态设置;StateStyle.Symbol 配置状态内 Symbol 样式。
  • 优化 Bezier 平滑算法、数据项索引维护与修复;移除 SerieSymbol.selectedSize。

v3.1.0 / v3.0.x:3.x 框架定型

  • v3.1.0:新增 Settings.axisMaxSplitNumber(坐标轴最大分割数)、AxisName.onZero(坐标轴名称对齐 0 刻度)、Tooltip itemFormatter 的 {c0};优化 MinMax 范围精度、Painter 顶层拆分 Upper 与 Top、Legend 背景与内边距、TextMeshPro Sprite Asset 支持(#201);Since 特性开始标注参数引入版本。
  • v3.0.1:修复 Inspector foldout 箭头无法展开、AxisLabel 首尾标签显示控制等问题;优化文档自动生成与代码注释。
  • v3.0.0:3.x 主线首个正式版,宣称更稳健的底层框架、更强的性能、更小的序列化文件、更灵活的组件增删与二次开发能力;新增 Time 轴、SingleAxis、多坐标系(Grid/Polar/Radar/SingleAxis)、多动画方式、多交互、国际化支持、Widgets 与多个扩展图表。此版本对应的 BaseChart、Serie、MainComponent 框架奠定了当前 Runtime/Internal/ 的架构基础(BaseChart.cs、Serie.cs)。

v2.x 系列:double 数据时代与交互完善

  • v2.8.2:HeatmapChart 自定义 Tooltip formatter;优化 Radar 的 Tooltip 层级。
  • v2.8.1:Legend 新增 onLegendClick、onLegendEnter、onLegendExit 委托回调;修复 RingChart Tooltip 异常(#192)与 DataZoom minShowNum 设置报错。
  • v2.8.0:新增调试信息面板;修复 VisualMap、Radar 颜色(#187)、Axis 精度(#184)等问题;优化初始化(#190)。
  • v2.7.0:修复图表名称重复检查(#183)、分割线越出坐标系(#181)、{d} formatter 值 0 报错、YAxis AxisLabel.onZero 无效等问题;改进斑马柱状图。
  • v2.6.0:Symbol 新增 EmptyRect、EmptyTriangle、EmptyDiamond 类型;Radar 的 AxisLine 与 SplitLine 可分别控制;修复 formatter {c}(#175)、boundaryGap(#174)、ignore(#173)等问题。
  • v2.5.0:Tooltip.positionFunction 委托自定义位置;formatter 支持 {e}(#170);修复 PieChart 渐出动画结束时 label 不消失(#168)、GaugeChart 代码改 splitNumber 不刷新 label(#167)等问题。
  • v2.4.0:折线忽略数据支持断开或连接(Serie.ignoreLineBreak,#164);Animation.alongWithLinePath 匀速动画;Legend.textAutoColor 文本颜色跟随 Serie 颜色(#163);优化 Zebra 渐变与正负柱圆角对称。
  • v2.3.0(重要升级):数据存储从 float 升级为 double。升级提示明确要求:由于类型升级,float 到 double 的隐式转换可能存在精度问题,建议将所有原 float 数据类型手动改为 double。同时新增 MarkLine(#142)、Serie.iconStyle 统一图标配置、DataZoom.supportInsideScroll/supportInsideDrag(坐标系内滚动与拖拽)、DataZoom.orient、AxisLabel.showStartLabel/showEndLabel、AxisLabel/SerieLabel 的 formatter 委托(#145)等。
  • v2.2.x:TextStyle 支持 alignment、autoWrap、autoAlign;AxisLabel 支持 width/height 与 iconStyle/icons;insertDataHead 控制数据插入头/尾;GanttChart 独立为扩展模块(v2.2.0);LiquidChart 支持 Rect 形状;Settings.reversePainter 与 painter 材质参数;AxisTick.showStartTick/showEndTick;多轴支持(#132)。
  • v2.1.x / v2.0.x:重构 Theme(解决引用相同或缺失问题,#118/#131);新增 GanttChart(v2.1.0)、CandlestickChart(v2.1.0,#124);PieChart.minAngle 最小扇区角度(#117);DataZoom 支持数值轴(#71);Theme.Unbind 解绑按钮;Tooltip.ignoreDataShow;XChartsSettings.editorShowAllListData 配置 Inspector 是否显示全部列表数据。

v1.x 系列:组件体系成型与性能优化

  • v1.6.3:修复动画未开启时更新数据导致图表持续刷新、Unity2020 新建图表无法绘制等问题。
  • v1.6.2 / v1.6.0:v1.6.0 重要升级:用 Color32 替换 Color 以减少隐式转换(可能导致自定义颜色丢失,FAQ 见 faq.md);LineStyle.toColor/toColor2 设置折线水平渐变(取消 ItemStyle 设置折线渐变);PieChart.onPointerClickPie、BarChart.onPointerClickBar 回调;LiquidChart 数据变化动画;VisualMap/ItemStyle 配置折线渐变;Radar 支持 Tooltip formatter;Ring 环向渐变。
  • v1.5.x:新增 PolarChart、LiquidChart;Tooltip 新增 offset、AlwayShow、titleFormatter 的 {i} 占位符;formatter 支持 {.1};SerieLabel autoOffset;avoidLabelOverlap 避免饼图标签堆叠(#56);customFadeInDelay 等自定义延迟/时长回调(#58);Serie 的 large/largeThreshold 性能模式;numericFormatter 数值格式化(替代 forceENotation);Convert XY Axis 互换 XY 轴;Axis.inverse 坐标轴反转;AxisLabel.onZero。
  • v1.4.0:Check warning 检测功能;PieChart 通过 ItemStyle 设置边框;Axis.ceilRate 取整倍率;BarChart 圆角柱(itemStyle.cornerRadius);barType 胶囊柱状图;Serie.radarType 多圈/单圈雷达图;ItemStyle.tooltipFormatter 单独配置 Serie 的 Tooltip;SerieData 的 ItemStyle 与 Emphasis 独立配置。
  • v1.3.x / v1.2.0:新增 RingChart;Serie.clip 坐标系外裁剪;TextLimit 文本自适应;Radar 的 splitLine;Tooltip 的 backgroundImage、paddingLeftRight/paddingTopBottom、lineStyle、textStyle;AnimationFadeOut() 渐出动画;RefreshTooltip() 接口;折线图对数轴 Log 支持;Mask 遮罩;DataZoom minShowNum;AxisLabel 整数格式化({value:f0})。
  • v1.1.0:新增 GaugeChart 仪表盘;Serie.arcShaped 圆角支持(后更名为 roundCap);dataChangeEnable 数据更新动画;修复 Overlay 模式下 Tooltip 不显示等问题。
  • v1.0.x(首个正式版):v1.0.0 增加版本检测(Component -> XCharts -> Check For Update)、Package Manager 安装支持;barType 斑马柱状图、barPercentStack 百分比堆叠柱状图;VisualMap 视觉映射组件;ItemStyle、Emphasis 样式组件;Settings 全局参数组件;SerieLabel.LineType 饼图视觉引导线;Scatter 与 Line 组合图;自定义绘制回调 customDrawCallback;SmoothDash 平滑虚线;采样配置 sampleType/lineSampleDist/minShow/maxShow/maxCache;AnimationReset() 等。v1.0.3 支持 Hierarchy 右键 XCharts->LineChart 快捷创建。

v0.x 系列:项目起源与基础图表落地

  • v0.8.x(2019.08):PieChart 多饼图支持、SerieLabel 饼图标签(Center/Inside/Outside)、南丁格尔玫瑰图(Radius/Area)、EffectScatter、ScatterChart、多维数据、Symbol 标志图形、自定义编辑器;Demo11_AddSinCurve 动态正弦曲线示例(对应 Examples/Example11_AddSinCurve.cs);修复区域平滑折线图、调色盘颜色数超限等问题。
  • v0.5.0(2019.07):AxisLine 轴线与箭头、AxisLabel 刻度标签、PieChart selected 选中效果、SplitArea 分割区域、AxisName 轴名称、DataZoom 区域缩放、stepType 阶梯线图、InSameBar 非堆叠同柱、crossLabel 十字准星指示器、堆叠区域图、AxisMinMaxType、X 轴 Value 模式、负数数值轴;Tooltip 于 2019.03.21 加入;2018.11.01 增加 Default/Light/Dark 三种默认主题(对应 Resources/ 下的 XCTheme 资产)。
  • v0.1.0(2018.09.05):项目首个发布版本。

升级路径与迁移注意事项汇总

综合历次 Upgrade Note 与破坏性变更,升级时需重点检查:

  1. v2.3.0 数据精度:数据从 float 升级为 double,业务代码中的 float 类型建议同步改为 double,避免隐式转换精度问题。
  2. v1.6.0 颜色类型:Color 替换为 Color32,自定义颜色可能丢失,具体迁移方法见 Documentation~/en/faq.md。
  3. 组件参数移除:v3.2.0 移除 Emphasis 等旧组件与 highlightColor/highlightToColor;v3.3.0 移除 Tooltip 的 fixedXEnable/fixedYEnable;Legend.formatter 已废弃改用 LabelStyle.formatter(Runtime/Component/Legend/Legend.cs);DataZoom.minShowNum 已废弃改用 minZoomRatio。
  4. 接口更名:Covert* 系列统一更名为 Convert*(如 ConvertXYAxis());UdpateXAxisIcon() → UpdateXAxisIcon();DataZoom 的 minShowNum → minZoomRatio。
  5. 目录结构:v3.5.0 起文档目录结构调整,升级前建议备份并删除原 XCharts 目录再导入新版本,避免残留文件冲突。
  6. Since 特性:v3.1.0 起新增参数会以 <a href="https://link.gitcode.com/i/99cdae7d3f50e87361399aceab74f317" target="_blank">Since("vX.Y.Z")] 标注引入版本,可在源码(如 [Runtime/Component/Axis/Axis.cs 的 mainAxis)中直接检索,用于确认当前版本是否支持某个配置。

延伸阅读

登录后查看全文
XCharts