7.8 KiB
XCharts问答
返回首页
XChartsAPI接口
XCharts配置项手册
QA 1：如何调整坐标轴与背景的边距？
QA 2：如何让初始动画重新播放？
QA 3：如何自定义折线图、饼图等数据项的颜色？
QA 4：如何格式化文字，如我想给坐标轴标签加上单位？
QA 5：如何让柱形图的柱子堆叠显示？
QA 6：如何让柱形图的柱子同柱但不重叠？
QA 7：如何调整柱形图的柱子宽度和间距？
QA 8：如何调整柱形图单个柱子的颜色？
QA 9：如何调整图表的对齐方式？
QA 10：可以显示超过1000以上的大数据吗？
QA 11：折线图可以画虚线、点线、点划线吗？
QA 12：如何限定Y轴（Value轴）的值范围？
QA 13：如何自定义数值轴刻度大小？
QA 14：如何在数据项顶上显示文本？
QA 15：如何给数据项自定义图标？
QA 16：锯齿太严重，如何让图表更顺滑？
QA 17：为什么鼠标移上图表Tooltip不显示？
QA 18：如何取消Tooltip的竖线？
QA 19：如何让Y轴（数值轴）显示多位小数？
QA 20：如何用代码动态更新数据？
QA 21：如何显示图例？
QA 22：如何做成预设？
QA 23：如何在图表上画点画线等自定义内容？
QA 24：如何实现心电图类似的数据移动效果？
QA 25：如何使用背景组件？有什么条件限制？
如何调整坐标轴与背景的边距
答：Grid组件，可调整上下左右边距。
如何让初始动画重新播放
答：调用AnimationReset()接口。
如何自定义折线图、饼图等数据项的颜色
答：通过Theme的colorPalette调整，或者部分Serie下的LineStyle和ItemStyle。
如何格式化文字，如我想给坐标轴标签加上单位
答：通过formatter和numericFormatter参数，在Legend、Axis的AxisLabel、Tooltop、Serie的Label都提供该参数的配置。
如何让柱形图的柱子堆叠显示
答：设置Serie下的stack，stack相同的serie会堆叠显示在一个柱子上。
如何让柱形图的柱子同柱但不重叠
答：设置Serie下的barGap为-1，stack为空。
如何调整柱形图的柱子宽度和间距
答：调整Serie下的barWidth和barGap，多个serie时最后一个serie的barWidth和barGap有效。
如何调整柱形图单个柱子的颜色
答：可通过调整单个Data下的ItemStyle调整，也可以通过两个serie同柱不堆叠来实现，通过设置数据项为0来达到类似效果。
如何调整图表的对齐方式
答：默认为左下角对齐，暂不支持调整。可以通过包一层parent来辅助控制。（最新版本1.5.0及以上已支持任意锚点，可和做UI一样任意调整对其方式）。
可以显示超过1000以上的大数据吗
答：可以。但UGUI对单个Graphic限制65000个顶点，所以太多的数据不一定能显示完全。可通过设置采样距离sampleDist开启采样简化过密曲线。也可以通过设置一些参数来减少图表的顶点数有助于显示更多数据。如缩小图表的尺寸，关闭或减少坐标轴的客户端绘制，关闭Serie的symbol和label显示等。折线图的普通线图Normal比平滑线图Smooth占用顶点数更少。1.5.0以上版本可以设置large和largeThreshold参数配置性能模式。
折线图可以画虚线、点线、点划线吗
答：可以。通过Serie下的lineType选择线条样式。当要显示的数据过多（成千以上）数据间过密时建议使用Normal或者Step样式。
如何限定Y轴（Value轴）的值范围
答：设置Axis下的minMaxType为Custom，自定义min和max。
如何自定义数值轴刻度大小
答：默认时通过Axis下的splitNumer进行自动划分。也可以设置interval自定义刻度大小。
如何在数据项顶上显示文本
答：通过设置Serie下的Label。
如何给数据项自定义图标
答：通过设置Serie的data下的数据项可单独设置icon相关参数。
锯齿太严重，如何让图表更顺滑
答：开启抗锯齿设置（在Unity里设置）。调整UI渲染模式为Camera模式，开启MSAA，设置4倍或更高抗锯齿。锯齿只能减少难以避免，像素越高锯齿越不明显。
为什么鼠标移上图表Tooltip不显示
答：确认Tooltip是否开启。确认父节点是否关闭了鼠标事件。
如何取消Tooltip的竖线
答：设置Tooltip的type为None。
如何让Y轴（数值轴）显示多位小数
答：设置Axis下的AxisLabel中的formatter为{value:f1}或{value:f2}。1.5.0及以上版本通过numericFormatter设置。
如何用代码动态更新数据
答：请查阅Example下的代码，Example13_LineSimple.cs就是一个简单添加数据构建折线图的例子，其他Demo也都是通过代码控制不同的组件实现不同的功能，相关API请查看文档：XChartsAPI接口 。
如何显示图例
答：首先，你的serie里的name需有值不为空。然后开启Legend显示，里面的data可以默认为空，表示显示所有的图例。如果你只想显示部分serie的图例，在data中填入要显示的图例即可。
如何做成预设
答：请删除chart下所有的子组件再拖成预设。
如何在图表上画点画线等自定义内容
答：xcharts有自定义绘制回调customDrawCallback，具体可参考Demo12_CustomDrawing.cs
如何实现心电图类似的数据移动效果
答：参考Example目录下的Example_Dynamic.cs。主要通过设置maxCache参数实现。axis和serie都设置相同的maxCache。maxCache可固定数据个数，当数据超过设定时会先删除第一个在添加新数据，实现数据移动效果。
如何使用背景组件？有什么条件限制
答：设置background组件的show为true，但不一定就能激活背景组件。由于框架的局限性，背景组件有两个前提条件：一是图表的父节点不能用布局控制，因为背景组件和图表的节点关系是并行的，用了布局控制背景组件的位置就无法控制。二是图表的父节点只能有图表自己一个子节点，这是方便管理背景组件节点的需要，要不然并行关系的原因，容易错乱对不上。另外，调整图表的层级关系时最好先隐藏背景组件，这是会自动删除关联的背景组件节点。