📈📊🚀🚀🚀An elegant modern declarative data visualization chart framework for iOS, iPadOS and macOS. Extremely powerful, supports line, spline, area, areaspline, column, bar, pie, scatter, angular gauges, arearange, areasplinerange, columnrange, bubble, box plot, error bars, funnel, waterfall and polar chart types. 极其精美而又强大的跨平台数据可视化图表框架,支持柱状图、条形图、折线图、曲线图、折线填充图、曲线填充图、气泡图、扇形图、环形图、散点图、雷达图、混合图等各种类型的多达几十种的信息图图表,完全满足工作所需.
AAChartKit is an elegant and friendly (user-friendly && enviroment-friendly) chart framework for iOS, based on the open source
HighchartsJS 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.
🎂 Environment friendly. Support
iOS、
iPadOSand
macOS. Totally support
Objective-Clanguage, and there are more types version such as
Swiftlanguage version AAInfographics 、
Javalanguage version AAChartCore 、
Kotlinlanguage 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 chartand 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
animationeffect is exquisite, delicate, smooth and beautiful.
⛓ Chain programming. Supports
chain programming syntaxlike 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.
| 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 |
| :----: | :----: | :----: |
| |
|
|
Add following content
ruby pod 'AAChartKit', :git => 'https://github.com/AAChartModel/AAChartKit.git'to your
Podfile.
Run
pod installor
pod update.
Drag the
AAChartKitLibfolder into your project.
Add the following to your
.pchfile. ```objective-c
Add the following to your view controller file: ```objective-c
Create an instance object of chart view:
AAChartView
objective-c 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];
Configure the chart model properties:
AAChartModel
objective-c 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]), ]) ;
Draw the chart (this method is only called the first time you create an AAChartView instance object)
objective-c //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!!! 🌈🌈🌈
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)
objective-c //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 refreshes after the first drawing of graphics has completed. If you want to update the chart data only, you should use the function
aa_onlyRefreshTheChartDataWithChartModelSeries)
objective-c //Refresh the chart after the AAChartModel content is updated [_aaChartView aa_refreshChartWithChartModel:aaChartModel];
- Note: The following
DEMO pictureis aGIF dynamic picturewhich has a size of around 6M. If you don't see any dynamic preview, then this is because the picture resources were not fully loaded. In such a case please be patient and wait for the contents to finish loading. Maybe you need to reload this page.
you can monitor the user touch events message through implementing delegate function for AAChartView instance object
//Set AAChartView events delegate self.aaChartView.delegate = self;//implement AAChartView user touch events delegate function #pragma mark -- AAChartView delegate
The received touch events message contain following content
@interface AAMoveOverEventMessageModel : NSObject@property (nonatomic, copy) NSString *name; @property (nonatomic, strong) NSNumber *x; @property (nonatomic, strong) NSNumber *y; @property (nonatomic, copy) NSString *category; @property (nonatomic, strong) NSDictionary *offset; @property (nonatomic, assign) NSUInteger index;
@end
Monitoring user click events can achieve a variety of custom functions. For example, you can implement Double Charts Linkage through user click event callbacks. The example effects are as follows
AATooltipthrough
JavaScriptfunction
As we all know, AAChartKit support using
HTMLString. Most of time, the
headerFormat、
pointFormat、
footerFormatHTML string is enough for customizing chart tooltip string content, However, sometimes the needs of APP is so weird to satified, in this time, you can even customize the chart tooltip style via
formatterJavaScript function.
For example
/*Custom Tooltip Style ---*/ AATooltip *tooltip = aaOptions.tooltip; tooltip .useHTMLSet(true) .formatterSet(@AAJSFunc(function () { return ' 🌕 🌖 🌗 🌘 🌑 🌒 🌓 🌔
' + ' Support JavaScript Function Just Right Now !!!
' + ' The Gold Price For 2020 ' + this.x + ' Is ' + this.y + ' Dollars '; })) .valueDecimalsSet(@2) .backgroundColorSet(@"#000000") .borderColorSet(@"#000000") .styleSet(AAStyleColorSize(@"#FFD700", 12)) ;
you can get the customized tooltip style chart like this👇
aaOptions.tooltip .useHTMLSet(true) .formatterSet(@AAJSFunc(function () { let colorsArr = []; colorsArr.push("mediumspringgreen"); colorsArr.push("deepskyblue"); colorsArr.push("red"); colorsArr.push("sandybrown"); let wholeContentString ='◉ Time: ' + this.x + ' year
'; for (let i = 0;i < 4;i++) { let thisPoint = this.points[i]; let yValue = thisPoint.y; if (yValue != 0) { let spanStyleStartStr = '◉ '; let spanStyleEndStr = '
'; wholeContentString += spanStyleStartStr + thisPoint.series.name + ': ' + thisPoint.y + '℃' + spanStyleEndStr; } } return wholeContentString; })) .backgroundColorSet(@"#050505") .borderColorSet(@"#050505") ;
you can get the customized tooltip style chart like this👇
chart with value range segmentation
bands 🎀
chart with value range segmentation
lines 🧶
chart with value range segmentation
zones 🧱
typedef NSString *AAChartType;AACHARTKIT_EXTERN AAChartType const AAChartTypeColumn; //column chart AACHARTKIT_EXTERN AAChartType const AAChartTypeBar; //bar chart AACHARTKIT_EXTERN AAChartType const AAChartTypeArea; //area chart AACHARTKIT_EXTERN AAChartType const AAChartTypeAreaspline; //area spline chart AACHARTKIT_EXTERN AAChartType const AAChartTypeLine; //line chart AACHARTKIT_EXTERN AAChartType const AAChartTypeSpline; //spline chart AACHARTKIT_EXTERN AAChartType const AAChartTypeScatter; //scatter chart AACHARTKIT_EXTERN AAChartType const AAChartTypePie; //pie chart AACHARTKIT_EXTERN AAChartType const AAChartTypeBubble; //bubble chart AACHARTKIT_EXTERN AAChartType const AAChartTypePyramid; //pyramid chart AACHARTKIT_EXTERN AAChartType const AAChartTypeFunnel; //funnel chart AACHARTKIT_EXTERN AAChartType const AAChartTypeColumnrange; //column range chart AACHARTKIT_EXTERN AAChartType const AAChartTypeArearange; //area range chart AACHARTKIT_EXTERN AAChartType const AAChartTypeAreasplinerange; //area spline range chart AACHARTKIT_EXTERN AAChartType const AAChartTypeBoxplot; //box plot chart AACHARTKIT_EXTERN AAChartType const AAChartTypeWaterfall; //Waterfall chart AACHARTKIT_EXTERN AAChartType const AAChartTypePolygon; //polygon chart
typedef NSString *AAChartZoomType;AACHARTKIT_EXTERN AAChartZoomType const AAChartZoomTypeNone; AACHARTKIT_EXTERN AAChartZoomType const AAChartZoomTypeX; AACHARTKIT_EXTERN AAChartZoomType const AAChartZoomTypeY; AACHARTKIT_EXTERN AAChartZoomType const AAChartZoomTypeXY;
typedef NS_ENUM(NSInteger,AAChartAnimation) { AAChartAnimationLinear = 0, AAChartAnimationEaseInQuad, AAChartAnimationEaseOutQuad, AAChartAnimationEaseInOutQuad, AAChartAnimationEaseInCubic, AAChartAnimationEaseOutCubic, AAChartAnimationEaseInOutCubic, AAChartAnimationEaseInQuart, AAChartAnimationEaseOutQuart, AAChartAnimationEaseInOutQuart, AAChartAnimationEaseInQuint, AAChartAnimationEaseOutQuint, AAChartAnimationEaseInOutQuint, AAChartAnimationEaseInSine, AAChartAnimationEaseOutSine, AAChartAnimationEaseInOutSine, AAChartAnimationEaseInExpo, AAChartAnimationEaseOutExpo, AAChartAnimationEaseInOutExpo, AAChartAnimationEaseInCirc, AAChartAnimationEaseOutCirc, AAChartAnimationEaseInOutCirc, AAChartAnimationEaseOutBounce, AAChartAnimationEaseInBack, AAChartAnimationEaseOutBack, AAChartAnimationEaseInOutBack, AAChartAnimationElastic, AAChartAnimationSwingFromTo, AAChartAnimationSwingFrom, AAChartAnimationSwingTo, AAChartAnimationBounce, AAChartAnimationBouncePast, AAChartAnimationEaseFromTo, AAChartAnimationEaseFrom, AAChartAnimationEaseTo, };
Here are the ten concrete animation types of AAChartKit
| Back | Bounce | Circ | Cubic | Elastic |
|:---------:|:---------:|:---------:|:---------:|:---------:|
| |
|
|
|
|
| Expo | Quad | Quart | Quint | Sine |
|:---------:|:---------:|:---------:|:---------:|:---------:|
| |
|
|
|
|
AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, title); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSNumber *, titleFontSize); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, titleFontColor); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, titleFontWeight);AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, subtitle); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSNumber *, subtitleFontSize); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, subtitleFontColor); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, subtitleFontWeight);
AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSArray *, series);
AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, AAChartSubtitleAlignType, subtitleAlign); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, AAChartType, chartType); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, AAChartStackingType, stacking); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, AAChartSymbolType, symbol); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, AAChartSymbolStyleType, symbolStyle); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, AAChartZoomType, zoomType); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, AAChartAnimation, animationType);
AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, animationDuration); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, inverted); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, xAxisReversed); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, yAxisReversed); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, gradientColorEnabled); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, polar); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, dataLabelEnabled); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, dataLabelFontColor); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, dataLabelFontSize); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, dataLabelFontWeight); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, xAxisLabelsEnabled); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSNumber *, xAxisLabelsFontSize); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, xAxisLabelsFontColor); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, xAxisLabelsFontWeight); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSArray *, categories); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, xAxisGridLineWidth); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, xAxisTickInterval);
AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, xAxisVisible); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, yAxisVisible); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, yAxisLabelsEnabled); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString , yAxisTitle); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSNumber *, yAxisLabelsFontSize); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, yAxisLabelsFontColor); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, yAxisLabelsFontWeight); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, yAxisGridLineWidth); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSArray , colorsTheme); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, backgroundColor);
AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, tooltipEnabled); AAPropStatementAndPropSetFuncStatement(copy, AAChartModel, NSString *, tooltipValueSuffix); AAPropStatementAndPropSetFuncStatement(copy , AAChartModel, NSString *, tooltipValueString); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, tooltipCrosshairs); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, connectNulls); AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, legendEnabled);
AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, borderRadius); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, markerRadius);
AAPropStatementAndPropSetFuncStatement(assign, AAChartModel, BOOL, yAxisAllowDecimals); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSArray *, yAxisPlotLines); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, yAxisMax); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSNumber *, yAxisMin); AAPropStatementAndPropSetFuncStatement(strong, AAChartModel, NSArray *, yAxisTickPositions);
An An
_0_ _oo0oo_ o8888888o 88" . "88 (| -_- |) 0\ = /0 ___/`---'\___ .' \\| |// '. / \\||| : |||// \ / _||||| -:- |||||- \ | | \\\ - /// | | | \_| ''\---/'' |_/ | \ .-\__ '-' ___/-. / ___'. .' /--.--\ `. .'___ ."" '< `.___\__/___.' >' "". | | : `- \`.;`\ _ /`;.`/ - ` : | | \ \ `_. \_ __\ /__ _/ .-` / / =====`-.____`.___ \_____/___.-`___.-'===== `=---=' ***************************************************** ¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥ €€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€ $$$$$$$$$$$$$$$$$$$$$$$ BUDDHA_BLESS_YOU AWAY_FROM BUG
Language Version |
Project Name | Target Platform | Source Code Link |
---|---|---|---|
Swift | AAInfographics | iOS | https://github.com/AAChartModel/AAChartKit-Swift |
Objective C | AAChartKit | iOS | https://github.com/AAChartModel/AAChartKit |
Kotlin | AAInfographics | Android | https://github.com/AAChartModel/AAChartCore-Kotlin |
Java | AAChartCore | Android | https://github.com/AAChartModel/AAChartCore |
Pro Versions are more powerful data visualization frameworks that support more types beautiful chart like bellcurve, bullet, columnpyramid, cylinder, dependencywheel, heatmap, histogram, networkgraph, organization, packedbubble, pareto, sankey, series, solidgauge, streamgraph, sunburst, tilemap, timeline, treemap, variablepie, variwide, vector, venn, windbarb, wordcloud, xrange charts and so on.
Language |
Project Name | Target Platform | Source Code Link |
---|---|---|---|
Swift | AAInfographics-Pro | iOS | https://github.com/AAChartModel/AAChartKit-Swift-Pro |
Objective C | AAChartKit-Pro | iOS | https://github.com/AAChartModel/AAChartKit-Pro |
Kotlin | AAInfographics-Pro | Android | Coming Soon... |
Java | AAChartCore-Pro | Android | Coming Soon... |
AAChartKit is available under the MIT license. See the LICENSE file for more information.
series) content dynamically
column chart、bar chart、pie charts、scatterplot chart、bubble chart, etc.
CocoaPods
Carthage
AAOptionsmodel object properties freely