EChart 技术文档

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 来下载和安装依赖。

手动安装

1. 直接从 GitHub 下载最新版本的源码。
2. 解压缩后，将 /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;

许可证

EChart遵循Apache许可证，详细条款见项目中的 LICENSE 文件。

---

此文档旨在提供一个简明扼要的指南，帮助开发者快速上手EChart，实现高效的图表展示与互动功能。通过遵循这些步骤，您可以轻松地在您的iOS应用中集成丰富的数据可视化组件。

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