XCharts 版本演进全解读:从 v0.1.0 到 v3.15.0 的功能变迁与源码实现
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
Pie.pieType:支持实心饼图(Solid)与线框柄图(Wireframe)两种模式(Runtime/Serie/Pie/Pie.cs),PieHandler在Wireframe模式下走专门的线框绘制分支(PieHandler.cs)。Legend.itemInactiveOpacity:设置图例标记在非激活状态下的颜色透明度(Runtime/Component/Legend/Legend.cs),默认值为 0.3f,由 LegendHandler.cs 在绘制时根据active状态切换透明度。Axis.onLabelClick:坐标轴标签点击回调,签名形如Action<int, string>(Runtime/Component/Axis/Axis.cs),触发逻辑见 AxisHandler.cs:点击时传入索引与标签文本,可用于联动筛选等业务。Animation.Exchange:新增数据交换动画,一般用于数据排序场景。AnimationExchange继承自AnimationInfo(Runtime/Component/Animation/AnimationInfo.cs),默认时长 250ms,可通过animation.exchange配置(AnimationStyle.cs)。LabelStyle.fixedX/fixedY:固定标签坐标,使标签不再跟随数据点位置(Runtime/Component/Label/LabelStyle.cs)。ItemStyle.backgroundGap:设置数据项背景的间距(Runtime/Component/Child/ItemStyle.cs),在柱状图背景绘制中用于控制背景与柱体的留白。
此外本版本还引入了 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 刻度)、TooltipitemFormatter的{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)与 DataZoomminShowNum设置报错。 - v2.8.0:新增调试信息面板;修复 VisualMap、Radar 颜色(#187)、Axis 精度(#184)等问题;优化初始化(#190)。
- v2.7.0:修复图表名称重复检查(#183)、分割线越出坐标系(#181)、
{d}formatter 值 0 报错、YAxisAxisLabel.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};SerieLabelautoOffset;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遮罩;DataZoomminShowNum;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刻度标签、PieChartselected选中效果、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 与破坏性变更,升级时需重点检查:
- v2.3.0 数据精度:数据从
float升级为double,业务代码中的float类型建议同步改为double,避免隐式转换精度问题。 - v1.6.0 颜色类型:
Color替换为Color32,自定义颜色可能丢失,具体迁移方法见 Documentation~/en/faq.md。 - 组件参数移除:v3.2.0 移除
Emphasis等旧组件与highlightColor/highlightToColor;v3.3.0 移除 Tooltip 的fixedXEnable/fixedYEnable;Legend.formatter已废弃改用LabelStyle.formatter(Runtime/Component/Legend/Legend.cs);DataZoom.minShowNum已废弃改用minZoomRatio。 - 接口更名:
Covert*系列统一更名为Convert*(如ConvertXYAxis());UdpateXAxisIcon()→UpdateXAxisIcon();DataZoom的minShowNum→minZoomRatio。 - 目录结构:v3.5.0 起文档目录结构调整,升级前建议备份并删除原 XCharts 目录再导入新版本,避免残留文件冲突。
Since特性:v3.1.0 起新增参数会以<a href="https://link.gitcode.com/i/99cdae7d3f50e87361399aceab74f317" target="_blank">Since("vX.Y.Z")]标注引入版本,可在源码(如 [Runtime/Component/Axis/Axis.cs 的mainAxis)中直接检索,用于确认当前版本是否支持某个配置。
延伸阅读
- 完整 API 参考:Documentation~/en/api.md
- 全部配置项手册:Documentation~/en/configuration.md
- 五分钟上手教程:Documentation~/en/tutorial01.md
- 常见问题与迁移 FAQ:Documentation~/en/faq.md
- 源码核心目录:Runtime/Internal/(BaseChart 框架)、Runtime/Serie/(系列实现)、Runtime/Component/(组件体系)、Runtime/Coord/(坐标系)
- 示例代码:Examples/(覆盖折线、柱状、饼图、雷达、散点、热力图、极坐标、K 线等全类型)
- 版本元信息:package.json(当前版本 3.15.0,最低 Unity 2018.3)