ZFChart

A simple chart library for iOS , contains barChart, lineChart, pieChart, waveChart. Thanks for your star if you like.

模仿PNChart写的一个图表库，用法简单，暂时有柱状图，线状图，饼图，波浪图四种类型，带动画效果，后续可能会更新新的类型，喜欢的欢迎star一个，有任何建议或问题可以加QQ群交流：451169423

###用法: 第一步(step 1) 将项目里ZFChart整个文件夹拖进新项目

    第二步(step 2)
    #import "ZFChart.h"
    
    第三步(step 3)

ZFGenericChartDataSource数据源方法

@required 必须实现的方法

    //返回value数据
    //当只有1组数据时，NSArray存储 @[@"1", @"2", @"3", @"4"]
      当有多组数据时，NSArray存储 @[@[@"123", @"300", @"490", @"380", @"167", @"235"], @[@"256", @"283", @"236", @"240", @"183", @"200"], , @[@"256", @"256", @"256", @"256", @"256", @"256"]] 
    //barChart: 代表有6组，每组有3个item
    //lineChart: 代表有6组，每组有3个item（另一种理解就是有3条线，每条线上有6个点）
    
    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart;

@optional 可选实现的方法

    //返回名称数组(NSArray必须存储NSString类型)
    
    - (NSArray *)nameArrayInGenericChart:(ZFGenericChart *)chart{
            return @[@"一年级", @"二年级", @"三年级", @"四年级", @"五年级", @"六年级"];
    }
    
    
    //返回颜色数组(NSArray必须存储UIColor类型, 若不设置，默认随机) 
    //barChart: 若每组有3个item,则返回3个颜色
    //lineChart：若有3条线，则返回3个颜色
    
    - (NSArray *)colorArrayInGenericChart:(ZFGenericChart *)chart{
            return @[ZFSkyBlue, ZFOrange, ZFMagenta];
    }
    
    
    //y轴数值显示的上限(若不设置，默认返回数据源最大值)
    
    - (CGFloat)yLineMaxValueInGenericChart:(ZFGenericChart *)chart;
    
    //y轴数值显示的最小值(若不设置，默认返回数据源最小值)
    //(PS:当 isResetYLineMinValue 为NO时，此方法无效)(When isResetYLineMinValue is NO, the method is invalid)
    
    - (CGFloat)yLineMinValueInGenericChart:(ZFGenericChart *)chart;
    
    
    //y轴数值显示的段数(若不设置,默认5段)
    
    - (NSInteger)yLineSectionCountInGenericChart:(ZFGenericChart *)chart;

BarChart(柱状图)

    须遵循ZFGenericChartDataSource数据源协议

    ZFBarChart * barChart = [[ZFBarChart alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT - NAVIGATIONBAR_HEIGHT)];
    barChart.dataSource = self;
    barChart.delegate = self;
    barChart.topic = @"xx小学各年级人数";
    barChart.unit = @"人";
    [barChart strokePath];
    [self.view addSubview:barChart];

ZFBarChartDelegate协议方法

@optional 可选实现的方法

    //x轴value文本颜色数组(若不设置，则全部返回黑色)
    //返回UIColor或者NSArray(NSArray里必须存储UIColor类型)
    
    - (id)valueTextColorArrayInChart:(ZFGenericChart *)chart;


    //bar宽度(若不设置，默认为25.f)
    
    - (CGFloat)barWidthInBarChart:(ZFBarChart *)barChart;
    
    
    //组与组之间的间距(若不设置,默认为20.f)
    
    - (CGFloat)paddingForGroupsInBarChart:(ZFBarChart *)barChart;
    
    
    //每组里面，bar与bar之间的间距(若不设置，默认为5.f)(当只有一组数据时，此方法无效)
    
    - (CGFloat)paddingForBarInBarChart:(ZFBarChart *)barChart;

####效果展示

    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart{
            return @[@"123", @"256", @"300", @"283", @"490", @"236"];
    }

    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart{
            NSArray * array1 = @[@"123", @"300", @"490", @"380", @"167", @"235"];
            NSArray * array2 = @[@"256", @"283", @"236", @"240", @"183", @"200"];
            NSArray * array3 = @[@"256", @"256", @"256", @"256", @"256", @"256"];

            return @[array1, array2, array3];
    }

    //当只有一组数据时，必须返回UIColor
    - (id)valueTextColorArrayInChart:(ZFGenericChart *)chart{
            return ZFBlue;
    }

    //当有多组数据时，若返回UIColor，则所有value颜色一致
    - (id)valueTextColorArrayInChart:(ZFGenericChart *)chart{
            return ZFBlue;
    }

    //当有多组数据时，若返回NSarray，效果如上
    - (id)valueTextColorArrayInChart:(ZFGenericChart *)chart{
            return @[ZFColor(71, 204, 255, 1), ZFColor(253, 203, 76, 1), ZFColor(16, 140, 39, 1)];
    }

LineChart(线状图)

    须遵循ZFGenericChartDataSource数据源协议
    
    ZFLineChart * lineChart = [[ZFLineChart alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT - NAVIGATIONBAR_HEIGHT)];
    lineChart.dataSource = self;
    lineChart.delegate = self;
    lineChart.topic = @"xx小学各年级男女人数";
    lineChart.unit = @"人";
    [lineChart strokePath];
    [self.view addSubview:lineChart];

ZFLineChartDelegate协议方法

@optional 可选实现的方法

    //组宽(若不设置，默认为25.f)
    
    - (CGFloat)groupWidthInLineChart:(ZFLineChart *)lineChart;
    
    
    //组与组之间的间距(若不设置，默认为20.f)
    
    - (CGFloat)paddingForGroupsInLineChart:(ZFLineChart *)lineChart
    
    
    //圆的半径(若不设置，默认为5.f)
    
    - (CGFloat)circleRadiusInLineChart:(ZFLineChart *)lineChart;
    
    
    线宽(若不设置，默认为2.f)
    
    - (CGFloat)lineWidthInLineChart:(ZFLineChart *)lineChart;

####效果展示

    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart{
            return @[@"123", @"256", @"300", @"283", @"490", @"236"];
    }

    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart{
            NSArray * array1 = @[@"123", @"300", @"490", @"380", @"167", @"451"];
            NSArray * array2 = @[@"380", @"200", @"326", @"240", @"50", @"137"];
            NSArray * array3 = @[@"256", @"300", @"89", @"430", @"256", @"256"];

            return @[array1, array2, array3];
    }

PieChart(饼图)

    须遵循ZFPieChartDataSource数据源方法

    ZFPieChart * pieChart = [[ZFPieChart alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT - NAVIGATIONBAR_HEIGHT)];
    pieChart.dataSource = self;
    pieChart.topic = @"xx小学各年级男女人数占比";
    [pieChart strokePath];
    [self.view addSubview:pieChart];

ZFPieChartDataSource数据源方法

@required 必须实现的方法

    //返回value数据(NSArray必须存储NSString类型)
    
    - (NSArray *)valueArrayInPieChart:(ZFPieChart *)chart;
    
    
    //返回颜色数组(NSArray必须存储UIColor类型)
    
    - (NSArray *)colorArrayInPieChart:(ZFPieChart *)chart;

@optional 可选实现的方法

    //返回名称数据(NSArray必须存储NSString类型)
    
    - (NSArray *)nameArrayInPieChart:(ZFPieChart *)chart

####效果展示

###饼图其余属性

    该属性默认为NO，设置YES时，饼图将显示详细信息，如上所示
    pieChart.isShowDetail = YES;

    该属性默认为YES，设置NO时，饼图将不显示饼图上的百分比，如上所示
    pieChart.isShowPercent = NO;

    该属性默认为kPercentTypeDecimal(显示2位小数)，当设置kPercentTypeInteger时，将显示四舍五入后的整数，如上所示
    pieChart.percentType = kPercentTypeInteger;

    该属性默认为kPieChartPatternTypeForCirque(圆环)，当设置kPieChartPatternTypeForCircle时，则以整圆的形式显示，如上所示
    pieChart.piePatternType = kPieChartPatternTypeForCircle;

WaveChart(波浪图)

    须遵循ZFGenericChartDataSource数据源协议
    
    ZFWaveChart * waveChart = [[ZFWaveChart alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, SCREEN_HEIGHT - NAVIGATIONBAR_HEIGHT)];
    waveChart.dataSource = self;
    waveChart.delegate = self;
    waveChart.topic = @"xx小学各年级人数";
    waveChart.unit = @"人";
    [waveChart strokePath];
    [self.view addSubview:waveChart];

ZFWaveChartDelegate协议方法

@optional 可选实现的方法

    //组宽(若不设置，默认为25.f)
    
    - (CGFloat)groupWidthInWaveChart:(ZFWaveChart *)waveChart;
    
    
    //组与组之间的间距(若不设置，默认为20.f)
    
    - (CGFloat)paddingForGroupsInWaveChart:(ZFWaveChart *)waveChart;


    //path颜色(若不设置，默认为ZFSkyBlue)
    
    - (UIColor *)pathColorInWaveChart:(ZFWaveChart *)waveChart;

####效果展示

    //波浪图只支持显示1组数据，NSArray里只能存NSString类型
    - (NSArray *)valueArrayInGenericChart:(ZFGenericChart *)chart{
            return @[@"123", @"256", @"300", @"283", @"490", @"236"];
    }

    //设置波浪样式，默认为(kWavePatternTypeForCurve)
    waveChart.wavePatternType = kWavePatternTypeForSharp

###其余说明

    1.可根据自身图表需求进行框架瘦身
    柱状图(ZFBarChart)

    线状图(ZFLineChart)

    饼图(ZFPieChart)

    波浪图(ZFWaveChart)

    2.  ZFGenericChartDataSource是柱状图(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)的数据源方法
        ZFPieChartDataSource是饼图(ZFPieChart)的数据源方法
        根据自身使用的图表遵循对应的数据源
    
    3.  ZFBarChartDelegate是柱状图(ZFBarChart)的部分常量设置的协议方法
        ZFLineChartDelegate是线状图(ZFLineChart)的部分常量设置的协议方法
        ZFWaveChartDelegate是波浪图(ZFWaveChart)的部分常量设置的协议方法
    
    4.  饼图(ZFPieChart)只有DataSource数据源方法，没有Delegate的协议方法
    
    5.  因再一次进行封装，柱状图(ZFBarChart)，线状图(ZFLineChart)，波浪图(ZFWaveChart)均继承ZFGenericChart，故ZFGenericChartDataSource数据源方法 和 通用属性请查看 ZFGenericChart.h
        ZFBarChartDelegate协议方法 和 柱状图(ZFBarChart)专有属性 请查看 ZFBarChart.h
        ZFLineChartDelegate协议方法 和 线状图(ZFLineChart)专有属性 请查看 ZFLineChart.h
        ZFPieChartDataSource数据源方法 和 饼图(ZFPieChart)其余属性 请查看 ZFPieChart.h
        ZFWaveChartDelegate协议方法 和 波浪图(ZFWaveChart)专有属性 请查看 ZFWaveChart.h
    
    6.(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)的valueLabel新增气泡样式，对应属性valueLabelPattern，现已默认为
      kPopoverLabelPatternPopover(气泡样式)，若要改回原样式，则设置为kPopoverLabelPatternBlank；
      
      eg:  barChart.valueLabelPattern = kPopoverLabelPatternBlank;
      
    7.关于自定义设置y轴最小值说明：
      /** 该属性是否重设y轴最小值，默认为NO(不设置，从0开始)，当设置为YES时，则有以下2种情况
          ①若同时实现代理方法中的 - (CGFloat)yLineMinValueInGenericChart:(ZFGenericChart *)chart，则y轴最小值为该方法的返回值
          ②若不实现①中的方法，则y轴最小值为数据源最小值


          Default is No (Start to O). When set to YES, then there are 2 kinds of situations:
          ①If at the same time to implement the method in ZFGenericChartDataSource:
           ||- (CGFloat)yLineMinValueInGenericChart:(ZFGenericChart *)chart||,
           then yLineMinValue is the return value of the method.
          ②If not implemented the method in ①, then yLineMinValue is the minimum value of the dataSource.
       */
       @property (nonatomic, assign) BOOL isResetYLineMinValue;
      
    8.每当更新数据后或更改属性设置，则需重新调用一次 - (void)strokePath 方法。
      网络获取数据后，才调用 - (void)strokePath 方法

###更新日志 2016.02.25 初版发布

    2016.02.26 新增柱状图和线状图表上的数值显示
    
    2016.02.29 ①新增阴影效果
               ②新增线状图Value位置选项
               
    2016.03.23 ①添加柱状图,线状图多组数据显示
               ②更改数据源传入模式，用法请参考UITableView
               ③饼图新增整圆模式
               若更新，请删除旧版本的文件
               
    2016.03.30 ①新增波浪图表(ZFWaveChart)
               ②柱状图(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)的valueLabel新增气泡样式，
                请查看ZFPopoverLabel.h的kPopoverLabelPattern枚举类型
               ③(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)新增坐标轴的分割线显示
               ④优化线状图(LineChart)重绘时在真机上卡帧问题
               ⑤修复其余Bug
               
    2016.04.07 ①波浪图(ZFWaveChart)新增曲线样式
               ②柱状图(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)新增事件点击代理，
                点击bar,圆或popoverLaber进行后续操作，具体看Demo和对应的代理方法
                
    2016.04.29 ①新增是否以动画展示
               ②新增y轴最小值自定义设置，具体用法看上其余说明或看Demo说明
               ③新增坐标轴自定义颜色设置
               ④本次更新进行了进一步的封装，故柱状图(ZFBarChart),线状图(ZFLineChart),波浪图(ZFWaveChart)的通用属性设置
                现已全部挪动到他们的父类ZFGenericChart.h，各自专有的属性依旧在他们自身.h文件

##本人其他开源框架 ####ZFChart - 一款简单好用的图表库，目前有柱状，线状，饼图，波浪图类型 ####ZFScan - 仿微信二维码/条形码扫描

Name		Name	Last commit message	Last commit date
Latest commit History 102 Commits
ZFChartView		ZFChartView
.gitignore		.gitignore
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

ZFChart

ZFGenericChartDataSource数据源方法

@required 必须实现的方法

@optional 可选实现的方法

BarChart(柱状图)

ZFBarChartDelegate协议方法

@optional 可选实现的方法

LineChart(线状图)

ZFLineChartDelegate协议方法

@optional 可选实现的方法

PieChart(饼图)

ZFPieChartDataSource数据源方法

@required 必须实现的方法

@optional 可选实现的方法

WaveChart(波浪图)

ZFWaveChartDelegate协议方法

@optional 可选实现的方法

About

Releases

Packages

Languages

a3101380/ZFChart

Folders and files

Latest commit

History

Repository files navigation

ZFChart

ZFGenericChartDataSource数据源方法

@required 必须实现的方法

@optional 可选实现的方法

BarChart(柱状图)

ZFBarChartDelegate协议方法

@optional 可选实现的方法

LineChart(线状图)

ZFLineChartDelegate协议方法

@optional 可选实现的方法

PieChart(饼图)

ZFPieChartDataSource数据源方法

@required 必须实现的方法

@optional 可选实现的方法

WaveChart(波浪图)

ZFWaveChartDelegate协议方法

@optional 可选实现的方法

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages