7.5 KiB
sidebar_position, slug
| sidebar_position | slug |
|---|---|
| 41 | /faq |
常见问题
FAQ 1：如何调整坐标轴与背景的边距？
调整Grid组件，可调整上下左右边距。
FAQ 2：如何让初始动画重新播放？
调用chart.AnimationReset()接口。
FAQ 3：如何自定义折线图饼图的颜色？
通过Theme的colorPalette调整，或者部分Serie下的LineStyle和ItemStyle。
FAQ 4：如何给坐标轴上的文本加上单位？
通过formatter和numericFormatter参数，在Legend、Axis的AxisLabel、Tooltop、Serie的Label都提供该参数的配置。
FAQ 5：如何让柱形图的柱子堆叠显示？
设置Serie下的stack，stack相同的serie会堆叠显示在一个柱子上。
FAQ 6：如何让柱形图的柱子同柱但不重叠？
设置Serie下的barGap为-1，stack为空。
FAQ 7：如何调整柱形图的柱子宽度和间距？
调整Serie下的barWidth和barGap，多个serie时最后一个serie的barWidth和barGap有效。
FAQ 8：如何调整柱形图单个柱子的颜色？
可通过调整单个Data下的ItemStyle调整，也可以通过两个serie同柱不堆叠来实现，通过设置数据项为0来达到类似效果。
FAQ 9：如何调整图表的对齐方式？
调整RectTransform的锚点，和UGUI的其他组件的用法一致。
FAQ 10：可以显示超过1000以上的大数据吗？
可以。但UGUI对单个Graphic限制65000个顶点，所以太多的数据不一定能显示完全。可通过设置采样距离sampleDist开启采样简化过密曲线。也可以通过设置一些参数来减少图表的顶点数有助于显示更多数据。如缩小图表的尺寸，关闭或减少坐标轴的客户端绘制，关闭Serie的symbol和label显示等。折线图的普通线图Normal比平滑线图Smooth占用顶点数更少。1.5.0以上版本可以设置large和largeThreshold参数来开启性能模式。
FAQ 11：折线图可以画虚线、点线、点划线吗？
可以。通过Serie下的lineType选择线条样式。当要显示的数据过多（成千以上）数据间过密时建议使用Normal或者Step样式。
FAQ 12：如何限定Y轴的值范围？
设置Axis下的minMaxType为Custom，自定义min和max。
FAQ 13：如何自定义数值轴刻度大小？
默认时通过Axis下的splitNumer进行自动划分。也可以设置interval自定义刻度大小。
FAQ 14：如何在数据项顶上显示文本？
通过设置Serie下的Label。3.0版本需要先添加LabelStyle组件。
FAQ 15：如何给数据项自定义图标？
通过设置Serie的data下的数据项可单独设置icon相关参数。
FAQ 16：锯齿太严重，如何让图表更顺滑？
开启抗锯齿设置（在Unity里设置）。调整UI渲染模式为Camera模式，开启MSAA，设置4倍或更高抗锯齿。
FAQ 17：为什么鼠标移上图表Tooltip不显示？
确认Tooltip是否开启；确认父节点是否关闭了鼠标事件。
FAQ 18：如何取消Tooltip的竖线？
设置Tooltip的type为None。或者调整lineStyle的参数。
FAQ 19：如何自定义Tooltip的显示内容？
自定义总的内容可以通过Tooltip的formatter。如果只是想调整所有的serie的显示格式可以用itemFormatter和titleFormatter结合。如果想每个serie的显示格式不一样，可以定制serie的itemStyle里的tooltipFormatter。具体的用法请查阅XCharts配置项手册。
FAQ 20：如何让y轴显示多位小数？
设置Axis下的AxisLabel中的formatter为{value:f1}或{value:f2}。1.5.0及以上版本通过numericFormatter设置。
FAQ 21：如何用代码动态更新数据？
请查阅Example下的代码，Example13_LineSimple.cs就是一个简单添加数据构建折线图的例子，其他Demo也都是通过代码控制不同的组件实现不同的功能，相关API请查看文档：XChartsAPI接口 。
FAQ 22：如何显示图例？为什么有时候图例无法显示？
首先，你的serie里的name需有值不为空。然后开启Legend显示，里面的data可以默认为空，表示显示所有的图例。如果你只想显示部分serie的图例，在data中填入要显示的图例的name即可。如果data中的值都不是系列的name，那图例就不会显示。
FAQ 23：如何做成预设？
做成prefab前，执行一下Rebuild Chart Object重新刷新节点，避免有冗余的节点存在。
FAQ 24：如何在图表上画点画线等自定义内容？
XCharts有自定义绘制回调onCustomDraw，具体可参考Example12_CustomDrawing.cs
FAQ 25：如何实现心电图类似的数据移动效果？
参考Example目录下的Example_Dynamic.cs。主要通过设置maxCache参数实现。axis和serie都设置相同的maxCache。maxCache可固定数据个数，当数据超过设定时会先删除第一个在添加新数据，实现数据移动效果。
FAQ 26：如何使用背景组件？有什么条件限制？
设置background组件的show为true。
FAQ 27：Mesh can not have more than 65000 vertices？
这是UGUI对单个Graphic的顶点数限制。XCharts是将图形绘制在单个Graphic上，所以也会有这个限制。解决的办法可以参考：FAQ 10：可以显示超过1000以上的大数据吗？
FAQ 28：为什么serie里设置的参数运行后又被重置了？
检测下代码里是否调用了RemoveData()并重新添加Serie了。如果想保留Serie的配置可以只ClearData()，然后重新添加数据。
FAQ 29：如何修改serie的symbol的颜色？
Symbol 的颜色是使用的 ItemStyle 的 color。
FAQ 30：导入或更新XCharts时TMP报错如何处理？
XCharts默认时不开启TMP，所以asmdef上没有TMP的引用。当本地开启TMP后再更新XCharts可能会出现这个问题。可通过以下两种方式的任意一种解决：
- 找到
XCharts.Runtime.asmdef和XCharts.Editor.asmdef，手动加上TextMeshPro的引用 - 移除
PlayerSetting中Scripting Define Symbols的dUI_TextMeshPro宏
3.8.0版本后增加XCharts-Daemon守护程序，将XCharts-Daemon导入项目后，在更新XCharts时守护程序会自动根据本地开启的TMP情况刷新asmdef，确保编译正常。
FAQ 31：支持空数据吗？如何实现折线图断开的效果？
Serie的data是double类型，所以无法表示空数据。可通过开启Serie的ignore和指定ignoreValue来达到空数据的效果。也可以每个SerieData设置ignore参数。忽略数据后断开还是连接可设置ignoreLineBreak参数。
FAQ 32：2.x版本升级3.x版本时常见的问题有哪些？
- 出现：
'XCharts.Runtime.XChartsMgr' is missing the class attribute 'ExtensionOfNativeClass'!的问题时，是因为3.x版本时不需要挂载XChartsMgr，直接删掉场景上的_xcharts_节点即可。
FAQ 33：折线图如何两边不留空白而从0坐标开始显示？
设置X轴的boundaryGap参数。
FAQ 34：如何设置部分Serie不显示Tooltip？
serie的itemStyle的itemFormatter设置为-可以忽略该serie的tooltip。
FAQ 35：区域折线图在用半透明颜色时有时候会一条叠加的线
这是区域折线图绘制的bug。可以用浅的不透的颜色替代半透明颜色。