EChart 技术文档

原创于 2024-10-18 10:36:35 发布 · 609 阅读

CC 4.0 BY-SA版权

EChart 技术文档

EChart iOS/iPhone/iPad Chart, Graph. Event handling and animation supported. 项目地址: https://gitcode.com/gh_mirrors/ec/EChart

EChart 是一个高度可扩展的图表库，具备事件处理能力和动画支持，简化Web端图表的创建过程，让你能够轻松集成并自定义复杂的可视化展示。

安装指南

使用 CocoaPods

如果你的项目已经集成了CocoaPods，添加以下代码到你的 Podfile 中：

platform :ios, '7.0'
pod "EChart"

然后在终端运行 pod install 来下载和安装依赖。

手动安装

直接从 GitHub 下载最新版本的源码。
解压缩后，将 /EChart/ 文件夹拖入你的Xcode项目中。

项目使用说明

快速启动 - 运行示例项目

最直观的学习方式是下载并运行 EChartDemo 项目，通过实际操作理解EChart的使用方法。

步骤 1: 将EChart加入项目

使用CocoaPods的方式已描述在安装指南中。若手动安装，确保已将 EChart 目录包含进你的项目。

步骤 2: 在视图控制器中引入EChart

确保你的视图控制器遵循 EColumnChartDelegate 和 EColumnChartDataSource 协议，并导入相应的头文件：

#import "EColumnChart.h"

@interface YourViewController () <EColumnChartDelegate, EColumnChartDataSource>

@property (nonatomic, strong) EColumnChart *eColumnChart;

@end

步骤 3: 初始化与布局

创建并配置EChart实例，例如使用 EColumnChart：

self.eColumnChart = [[EColumnChart alloc] initWithFrame:CGRectMake(40, 100, 250, 200)];
_eColumnChart.delegate = self;
_eColumnChart.dataSource = self;
[self.view addSubview:_eColumnChart];

项目API使用文档

数据源(DataSource)

为了填充图表数据并定义其行为，你需要实现以下几个方法：

列的数量
- (NSInteger)numberOfColumnsInEColumnChart:(EColumnChart *)eColumnChart;
每次显示的列数
- (NSInteger)numberOfColumnsPresentedEveryTime:(EColumnChart *)eColumnChart;
最高值获取
- (EColumnDataModel *)highestValueEColumnChart:(EColumnChart *)eColumnChart;
每列的数据
- (EColumnDataModel *)eColumnChart:(EColumnChart *)eColumnChart valueForIndex:(NSInteger)index;

代理(Delegate)

通过委托方法接收图表交互反馈：

单击柱状图
- (void)eColumnChart:(EColumnChart *)eColumnChart didSelectColumn:(EColumn *)eColumn;
手指进入柱子
- (void)eColumnChart:(EColumnChart *)eColumnChart fingerDidEnterColumn:(EColumn *)eColumn;
手指离开柱子
- (void)eColumnChart:(EColumnChart *)eColumnChart fingerDidLeaveColumn:(EColumn *)eColumn;
手指完全离开图表区域
- (void)fingerDidLeaveEColumnChart:(EColumnChart *)eColumnChart;