mirror of
https://github.com/XCharts-Team/XCharts.git
synced 2026-05-17 22:10:11 +00:00
81 lines
3.1 KiB
Markdown
81 lines
3.1 KiB
Markdown
# XCharts
|
||
A Simple UGUI Charting Library for Unity
|
||
|
||
# 特性
|
||
1. 支持折线图(`LineChart`)、柱状图(`BarChart`)、饼图(`PieChart`)、雷达图(`RadarChart`)等常用图表
|
||
2. 支持`Default`、`Light`、`Dark`三种主题切换
|
||
3. 参数可视化配置，效果实时预览，纯源码绘制
|
||
4. 折线图通过参数可配置出：折线图、曲线图、区域图等
|
||
5. 饼图通过参数可配置出：饼图、环形图、南丁格尔玫瑰图等
|
||
6. 支持多数据密集图表
|
||
|
||
# TODO
|
||
1. ~~`tooltip`~~（2019.3.21完成）
|
||
2. ~~多数据支持~~（2019.4.1完成）
|
||
2. 旭日图`sunburst`
|
||
3. 动画效果
|
||
|
||
# 更新日志
|
||
1. 2019.05.11：0.2版本，重构代码，增加Editor
|
||
|
||
# 效果图
|
||
1.`Default`主题
|
||
|
||
2.`Light`主题
|
||
|
||
3.`Dark`主题
|
||
|
||
4.多数据支持
|
||
|
||
# 配置项手册
|
||
* `Theme` 主题
|
||
+ `theme`：主题，`Default`、`Light`、`Dark`三种可选主题
|
||
+ `themeInfo`：各主题对应的默认配置，也可自己调整
|
||
* `Title` 标题
|
||
+ `show`：是否显示标题，标题默认现象在顶部
|
||
+ `text`：标题内容
|
||
+ `align`：对齐方式，`Left`、`Right`、`Center`三种可选对齐方式
|
||
+ `left`：左偏移量
|
||
+ `right`：右偏移量
|
||
+ `top`：顶部偏移量
|
||
+ `bottom`：低部偏移量
|
||
* `Legend` 图例
|
||
+ `show`：是否显示图例
|
||
+ `location`：图例显示在的位置，可选`Left`、`Right`、`Top`、`Bottom`四个位置
|
||
+ `itemWidth`：图例标记的图形宽度
|
||
+ `itemHeight`：图例标记的图形高度
|
||
+ `itemGap`：图例每项之间的间隔。横向布局时为水平间隔，纵向布局时为纵向间隔。
|
||
+ `left`：左偏移量
|
||
+ `right`：右偏移量
|
||
+ `top`：顶部偏移量
|
||
+ `bottom`：低部偏移量
|
||
+ `dataList`：图例的字符串数据数组
|
||
* `Coordinate` 坐标系
|
||
+ `show`：是否显示坐标系
|
||
+ `left`：左偏移量
|
||
+ `right`：右偏移量
|
||
+ `top`：顶部偏移量
|
||
+ `bottom`：低部偏移量
|
||
+ `tickness`：坐标轴线的粗细
|
||
+ `splitWidth`：坐标刻度的长度
|
||
* `XAxis` X坐标轴
|
||
+ `type`：坐标轴类型。可选：
|
||
- `value` 数值轴，适用于连续数据。
|
||
- `category` 类目轴，适用于离散的类目数据，为该类型时必须通过 data 设置类目数据。
|
||
+ `splitNumber`：分割段数
|
||
+ `maxSplitNumber`：最大分割段数，当data的数据大于该值时，会删除第一个data数据再添加
|
||
+ `showSplitLine`：是否显示分割线
|
||
+ `splitLineType`：分割线线的类型，可选：
|
||
- `solid`：实线
|
||
- `dashed`：虚线
|
||
- `dotted`：点
|
||
+ `boundaryGap`：坐标轴两边是否留白。默认为 true，这时候刻度只是作为分隔线，标签和数据点都会在两个刻度之间的带(`band`)中间。
|
||
+ `data`：类目数据，在类目轴（`type`: `'category'`）中有效。
|
||
* `YAxis` Y坐标轴，配置同`XAxis`
|
||
* `SeriesList` 系列列表数据，和图例对应
|
||
+ `legendKey`：对应的图例`key`
|
||
+ `showDataNumber`：显示数据个数，默认为`0`全部显示
|
||
+ `dataList`：`float`型数据数组
|
||
|
||
|