Skip to content

xuuhan/HXCharts

Repository files navigation

HXCharts

HXCharts包括了仪表盘、柱状图、圆形图、折线图、环形图等五种绘图。

仪表盘、柱状图、圆形图支持渐变色或单色,折线图、环形图只支持单色

柱状图支持水平和竖直两种方向并支持滑动

折线图支持负数。

环形图可以选择标注值所相对应与图表的上下左右四个方位。

仪表盘、柱状图、折线图可以自定义标注值的数量。

下面是在项目中使用HXCharts的实际效果:

image

语言

  • Objective-C

安装

  • 下载demo,将HXcharts文件夹拖入到自己项目中

版本

  • V1.2 : 新增环形图,环形图标注值支持上下左右四个方位布局

历史版本

  • V1.1 : 折线图支持负数,当出现负数时,会自动计算Y轴标注值个数,初始化自定义y轴个数参数将失效。

使用

image

  • 导入头文件
#import "HXCharts.h"

仪表盘

  • 用初始化方法并传入最大值与实际值
  • 传入颜色
  • 传入要显示标注值的数量
        HXGaugeChart *gauge = [[HXGaugeChart alloc] initWithFrame:CGRectMake(x, y, chartWidth, chartWidth) withMaxValue:300 value:225];
        
        gauge.valueTitle = @"225";
        gauge.colorArray = @[[self colorWithHexString:@"#33d24e" alpha:1],
                             [self colorWithHexString:@"#f8e71c" alpha:1],
                             [self colorWithHexString:@"#ff9500" alpha:1],
                             [self colorWithHexString:@"#ff4e65" alpha:1]];
        gauge.locations = @[@0.15,@0.4,@0.65,@0.8];
        gauge.markLabelCount = 5;
        
        [self.view addSubview:gauge];

圆形图

  • 用初始化方法并传入最大值与实际值
  • 传入颜色
        HXCircleChart *circle = [[HXCircleChart alloc] initWithFrame:CGRectMake(x, y, chartWidth, chartWidth) withMaxValue:100 value:85];
         
        circle.valueTitle = @"85%";
        
        circle.colorArray = @[[self colorWithHexString:@"#00fec7" alpha:1],[self colorWithHexString:@"#00d8fe" alpha:1]];
        
        circle.locations = @[@0.15,@0.85];
        
        [self.view addSubview:circle];

柱状图

  • 用初始化方法传入标注值的个数与绘图方向
  • 传入文字数组
  • 传入对应值数组
  • 传入柱子颜色数组与背景线颜色(默认灰色)
  • 要修改柱子的宽度需要去.m文件中修改_margin(柱子间间距)的值
        HXBarChart *bar = [[HXBarChart alloc] initWithFrame:CGRectMake(barChartX, barChartY, barChartWidth, barChartHeight) withMarkLabelCount:6 withOrientationType:OrientationHorizontal];
        
        bar.titleArray = @[@"一月",@"二月",@"三月",@"四月",@"五月",@"六月"];
        
        bar.valueArray = @[@"34",@"72",@"260",@"44",@"180",@"53"];
        
        bar.colorArray = @[color1,color2,color3,color4,color5,color6];
        
        bar.locations = @[@0.15,@.85];
        
        bar.backgroundLineColor = [self colorWithHexString:@"#4b4e52" alpha:1];
        
        [self.view addSubview:bar];

折线图

  • 初始化
  • 传入文字数组
  • 传入对应值数组
  • 传入画线颜色、填充颜色与背景线颜色(默认灰色)
HXLineChart *line = [[HXLineChart alloc] initWithFrame:CGRectMake(lineChartX, lineChartY, lineChartWidth, lineChartHeight)];
        
        [line setTitleArray:@[@"星期一",@"星期二",@"星期三",@"星期四",@"星期五",@"星期六",@"星期日"]];
        
        [line setValue:@[@11,@44,@193,@57,@66,@144,@156] withYLineCount:6];
        
        line.lineColor = [self colorWithHexString:@"#43befa" alpha:1];
        
        line.fillColor = [self colorWithHexString:@"#2e3f53" alpha:0.5];
        
        line.backgroundLineColor = [self colorWithHexString:@"#4b4e52" alpha:1];
        
        [self.view addSubview:line];

环形图

  • 初始化传入frame与标注值相对于图标的方位,MarkViewDirectionNone则不显示标注值,图表居中
  • 传入frame
  • 传入颜色数组
  • 传入数值数组
  • 传入文字数组
  • 调用绘图方法
HXRingChart *ring = [[HXRingChart alloc] initWithFrame:CGRectMake(ringChartX, ringChartY, ringChartWidth, ringChartHeight) markViewDirection:MarkViewDirectionRight];
        [self.view addSubview:ring];
        ring.colorArray = colorArray;
        ring.valueArray = valueArray;
        ring.titleArray = titleArray;
        ring.ringWidth = 20.0;
        ring.title = @"总计";
        [ring drawArc];

说明

demo中颜色使用的是渐变色,也可以选择单色,更多属性请去.h文件里看

License

HXCharts is available under the MIT license.

Releases

No releases published

Packages

No packages published