AAChartKit

<p align="center"> <a href="https://github.com/AAChartModel/AAChartKit"> <img src="https://img.shields.io/badge/Support-iOS | iPadOS | macOS -blue.svg"> </a> <a href="https://github.com/AAChartModel/AAChartCore"> <img src="https://img.shields.io/badge/Support-Android all platform -green.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit"> <img src="https://img.shields.io/badge/language-OC-red.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit-Swift"> <img src="https://img.shields.io/badge/language-Swift-orange.svg"> </a> <a href="https://github.com/AAChartModel/AAChartCore"> <img src="https://img.shields.io/badge/language-Java-yellow.svg"> </a> <a href="https://github.com/AAChartModel/AAChartCore-Kotlin"> <img src="https://img.shields.io/badge/language-Kotlin-green.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit-Swift"> <img src="https://img.shields.io/badge/support-Animation-yellow.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit-Swift"> <img src="https://img.shields.io/badge/support-Swift-orange.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit"> <img src="https://jaywcjlove.github.io/sb/lang/english.svg"> </a> <a href="https://github.com/AAChartModel/AAChartKit/blob/master/CHINESE-README.md"> <img src="https://jaywcjlove.github.io/sb/lang/chinese.svg"> </a> <a href="http://isitmaintained.com/project/AAChartModel/AAChartKit "Average time to resolve an issue""> <img src="http://isitmaintained.com/badge/resolution/AAChartModel/AAChartKit.svg"> </a> <a href="http://isitmaintained.com/project/AAChartModel/AAChartKit "Percentage of issues still open""> <img src="http://isitmaintained.com/badge/open/AAChartModel/AAChartKit.svg"> </a> </p>

English Document 🇬🇧 | 简体中文文档 🇨🇳

The Swift version of AAChartKit can be found here:

https://github.com/AAChartModel/AAChartKit-Swift

Preface

AAChartKit is an elegant and friendly (user-friendly && enviroment-friendly) chart framework for iOS, based on the open source Highcharts JS libraries. AAChartKit is extremely powerful, easy to configure and a pleasure to use. Currently AAChartKit includes support for the following chart types: column chart, bar chart, area chart, area spline chart, line chart, spline chart, radar chart, polar chart, pie chart, bubble chart, pyramid chart, funnel chart, column range and area range chart. More chart types are planned to be supported. AAChartKit gives you easy and fast access to a wide range of chart types, hassle-free and quick to integrate into your own project.

---

Features

• 🎂 Environment friendly. Support iOS 、iPadOS and macOS. Totally support Objective-C language, and there are more types version such as Swift language version AAInfographics 、 Java language version AAChartCore 、Kotlin language version AAInfographics . To get more details you can see the source code links list.

• 🚀 Powerful and easy to use. It supports column chart, bar chart, area chart, areaspline chart, line chart, spline chart, radar chart, polar chart, pie chart, bubble chart, pyramid chart, funnel chart, columnrange chart, arearange chart, mixed chart and other graphics. Support for more chart types is planned.

• 📝 Modern Declarative Syntax. Unlike previous imperative programming techniques, drawing any custom chart in AAChartKit, you don't need to care about the inner implementation details which is annoying && boring. Describe what you want, you will get what you described.

• 🎮 Interactive and animated. The charts animation effect is exquisite, delicate, smooth and beautiful.

• ⛓ Chain programming. Supports chain programming syntax like Masonry .

• 🦋 Minimalist. AAChartView + AAChartModel = Chart. The AAChartKit follows a minimalist formula: Chart view + Chart model = The chart you want, just like the powerful and beautiful charts lib AAInfographics.

• 🖱 Interaction event callback. Support for monitoring user click events and single finger move over events, which can be used to achieve double charts linked-working and even multiple charts linkage, as well as other more complex custom user interaction effects.

---

Beauty Appreciation

| Column Chart | Column Range Chart | Area Chart | | :----: | :----: | :----: | | | | |

| Line Chart | Step Area Chart | Step Line Chart | | :----: | :----: | :----: | | | | |

| Spline Chart | Areaspline Chart | Stacked Polar Chart | | :----: | :----: | :----: | | | | |

| Bubble Chart | Arearange Average Value Chart | Column Mixed Line Chart | | :----: | :----: | :----: | | | | |

| Scatter Chart | Boxplot Chart | Mirror Column Chart | | :----: | :----: | :----: | | | | |

Installation

CocoaPods (recommended practice)

1. Add following content

pod 'AAChartKit', :git => 'https://github.com/AAChartModel/AAChartKit.git'

to your Podfile.

2. Run pod install or pod update.

Manually (old school way)

1. Drag the AAChartKitLib folder into your project.

2. Add the following to your .pch file.

#import "AAGlobalMacro.h"

Usage

1. Add the following to your view controller file:

#import "AAChartKit.h"

2. Create an instance object of chart view:AAChartView

CGFloat chartViewWidth  = self.view.frame.size.width;
CGFloat chartViewHeight = self.view.frame.size.height - 250;
_aaChartView = [[AAChartView alloc]init];
_aaChartView.frame = CGRectMake(0, 60, chartViewWidth, chartViewHeight);
//_aaChartView.scrollEnabled = NO;
[self.view addSubview:_aaChartView];

3. Configure the chart model properties: AAChartModel

AAChartModel *aaChartModel = AAChartModel.new
.chartTypeSet(AAChartTypeArea)
.titleSet(@"THE HEAT OF PROGRAMMING LANGUAGE")
.subtitleSet(@"Virtual Data")
.categoriesSet(@[@"Java",@"Swift",@"Python",@"Ruby", @"PHP",@"Go",@"C",@"C#",@"C++"])
.yAxisTitleSet(@"Degrees Celsius")
.seriesSet(@[
    AASeriesElement.new
        .nameSet(@"2017")
        .dataSet(@[@7.0, @6.9, @9.5, @14.5, @18.2, @21.5, @25.2, @26.5, @23.3, @18.3, @13.9, @9.6]),
    AASeriesElement.new
        .nameSet(@"2018")
        .dataSet(@[@0.2, @0.8, @5.7, @11.3, @17.0, @22.0, @24.8, @24.1, @20.1, @14.1, @8.6, @2.5]),
    AASeriesElement.new
        .nameSet(@"2019")
        .dataSet(@[@0.9, @0.6, @3.5, @8.4, @13.5, @17.0, @18.6, @17.9, @14.3, @9.0, @3.9, @1.0]),
    AASeriesElement.new
        .nameSet(@"2020")
        .dataSet(@[@3.9, @4.2, @5.7, @8.5, @11.9, @15.2, @17.0, @16.6, @14.2, @10.3, @6.6, @4.8]),
]);

4. Draw the chart (this method is only called the first time you create an AAChartView instance object)

//The chart view object calls the instance object of AAChartModel and draws the final graphic
[_aaChartView aa_drawChartWithChartModel:aaChartModel];

🎉🎉🎉 Congratulations! Everything was done!!! You will get what you want!!! 🌈🌈🌈

Update chart content

If you want to refresh chart content, you should do something as follow. According to your actual needs, select the function that fits you.

• Refresh the chart data (this method is recommended for updating the series data dynamically)

//Refresh the chart dynamically only when the series attribute of the AAChartModel object is updated
[_aaChartView aa_onlyRefreshTheChartDataWithChartModelSeries:aaChartModelSeriesArray];

• Refresh the chart, minus the chart data (this method is recommended for subsequent ref