iBarChart 0.2

iBarChart 0.2

El Mahdi BOUKHRIS 维护。



  • El Mahdi BOUKHRIS

iBarChart

Version License Platform

预览

Alt text

作者

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;
  • 在没有任何条形图被选中时调用,通常发生在用户选中一个条形图使其高亮,然后再选中同一个条形图,使其取消高亮。

捐赠

如果本项目对您有所帮助,买我一杯咖啡☕️

paypal