iBarChart
预览
作者
El Mahdi BOUKHRIS, [email protected]
关于
iBarChart 是一个简单、完全可自定义且动态的垂直柱状图组件,可让您在 X 轴上绘制表示您的数据类型的图表,并在 Y 轴上显示一个百分比。
示例项目
包含的示例项目提供了 iBarChart 的演示。它显示了一个柱状图,并能够使用委托方法与柱子进行交互。
安装
本项目可通过 CocoaPods 获得。要安装,只需将 "iBarChart"
添加到您的 Podfile 中。
使用 iBarChart
iChartView
iBarChart 非常易于使用,您首先需要创建一个 iChartView 视图来承载您的图表(通过代码或 Interface Builder 创建,并链接到出口)。
您接下来需要准备数据,为此 提供了一个名为 BarData 的数据模型,它包含图表中每个条形的信息(y 轴标签、值 和 条形颜色)。您可以通过调用 2 种初始化方法之一实例化 BarData 对象
- (id) initWithValue:(int) value forLabel:(NSString*) label withColor:(UIColor*) color;
- (id) initWithValue:(int) value forLabel:(NSString*) label;
您可以为每个条形设置颜色或不清除,也可以混合使用。没有设置颜色的 BarData 对象将根据其值自动分配颜色
- [0, 40] = 类似红色的:[UIColor colorWithRed:251.0/255.0 green:0.0/255.0 blue:6.0/255.0 alpha:1.0]
- [40, 70] = 类似黄色的:[UIColor colorWithRed:253.0/255.0 green:149.0/255.0 blue:10.0/255.0 alpha:1.0]
- [70, 100] = 类似绿色的:[UIColor colorWithRed:15.0/255.0 green:113.0/255.0 blue:1.0/255.0 alpha:1.0]
一旦您的视图就位,且 iChartView 实例准备就绪,创建一个包含您的 BarData 对象的数组,并使用 2 种方法之一绘制您的图表
- (void) drawChartForPercentages:(NSMutableArray*) data;
- 每个 BarData 对象的 value 属性必须是 int 类型 ]0, 100]
- (void) drawChartForValues:(NSMutableArray*) data withMaxValue:(long) maxValue;
- maxValue 代表 100%,且每个 BarData 对象的 value 属性必须是一个 int 类型 ]0, maxValue]
iBarSelectionDelegate
iChartView 定义了一个名为 iBarSelectionDelegate 的选择代理。为了在使用图表时获得用户交互的回传,请让您的类实现 iBarSelectionDelegate 协议。
- (void) didSelectBarAtIndex:(int) index WithData:(BarData*) data;
- 当点击条形时调用,并给出选择的索引和负责绘制所选图表条的 BarData 对象。
- (void) didClearSelection;
- 在没有任何条形图被选中时调用,通常发生在用户选中一个条形图使其高亮,然后再选中同一个条形图,使其取消高亮。
捐赠
如果本项目对您有所帮助,买我一杯咖啡