GithubHelp home page GithubHelp logo

liuruxian / aachartkit Goto Github PK

View Code? Open in Web Editor NEW

This project forked from aachartmodel/aachartkit

0.0 2.0 0.0 7.36 MB

An elegant and friendly chart library for iOS developer. Powerful,support the 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 and other graphics.

License: MIT License

Objective-C 85.50% HTML 14.03% Ruby 0.47%

aachartkit's Introduction

AAChartKit 2.0

Support

There is the link of Swift version of AAChartKit as follow

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

中文使用说明书地址

https://github.com/AAChartModel/AAChartKit/blob/master/CHINESE-README.md

Features:

  1. Support iOS 6、ARC & Objective C.
  2. Powerful,support the 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 chartand other graphics.
  3. Interactive、animated,the animation effect is exquisite 、delicate、 smooth and beautiful.
  4. Support chain programming syntax like Masonry
  5. AAChartView + AAChartModel = Chart In the AAChartKit,it follows a minimalist formula: Chart view + Chart model = The chart you want.  

Usage:

The need of preparation

  1. Drag the folder AAChartKitLib into your project.
  2. Add the following content into your .pch file.
#import "AAGlobalMacro.h"

The offical start of the work

  1. Add the following content into your view controller file.
#import "AAChartView.h"
  1. Creat the object of chart view:AAChartView
CGFloat chartViewWidth  = self.view.frame.size.width;
CGFloat chartViewHeight = self.view.frame.size.height-250;
self.aaChartView = [[AAChartView alloc]initWithFrame:CGRectMake(0, 60, chartViewWidth, chartViewHeight)];
self.aaChartView.contentHeight = self.view.frame.size.height-250;
[self.view addSubview:self.aaChartView];
  1. Configure the properties of chart model:AAChartModel
    AAChartModel *chartModel= AAObject(AAChartModel)
    .chartTypeSet(AAChartTypeColumn)
    .titleSet(@"THE HEAT OF PROGRAMMING LANGUAGE")
    .subtitleSet(@"Virtual Data")
    .categoriesSet(@[@"Java",@"Swift",@"Python",@"Ruby", @"PHP",@"Go",@"C",@"C#",@"C++"])
    .yAxisTitleSet(@"Degrees Celsius")
    .seriesSet(@[
                 AAObject(AASeriesElement)
                 .nameSet(@"2017")
                 .dataSet(@[@45,@56,@34,@43,@65,@56,@47,@28,@49]),
                 
                 AAObject(AASeriesElement)
                 .nameSet(@"2018")
                 .dataSet(@[@11,@12,@13,@14,@15,@16,@17,@18,@19]),
                 
                 AAObject(AASeriesElement)
                 .nameSet(@"2019")
                 .dataSet(@[@31,@22,@33,@54,@35,@36,@27,@38,@39]),
                 
                 AAObject(AASeriesElement)
                 .nameSet(@"2020")
                 .dataSet(@[@21,@22,@53,@24,@65,@26,@37,@28,@49]),
                 ])
    ;
  1. Draw the chart(This method is called only for the first time after you create an AAChartView instance object)
//The chart view object calls the instance object of AAChartModel and draws the final graphic
[chartView aa_drawChartWithChartModel:chartModel];
  1. Refresh the chart(Subsequent refresh options are recommended to call this method after the first drawing of graphics is completed)
//Refresh the chart after the AAChartModel content is updated
[chartView aa_refreshChartWithChartModel:chartModel];
  1. Only refresh the chart data(This method is recommended to be called for updating the series data dynamically)
//Refresh the chart dynamically only when the series attribute of the AAChartModel object is updated
[chartView aa_onlyRefreshTheChartDataWithChartModel:chartModel];
  1. Special instructions

Pie chart and bubble chart are special in AAChartKit,if you want to draw these charts,you should do some different things for AAChartModel,for example

  • To draw a pie chart,you should configure the properties of AAChartModel like this:
   AAChartModel *chartModel= AAObject(AAChartModel)
    .chartTypeSet(AAChartTypePie)
    .titleSet(@"THE HEAT OF PROGRAMMING LANGUAGE")
    .subtitleSet(@"Virtual Data")
    .yAxisTitleSet(@"Degrees Celsius")
    .seriesSet(
               @[AAObject(AASeriesElement)
                 .nameSet(@"Percent")
                 .dataSet(@[
                            @[@"Java"  , @67],
                            @[@"Swift" , @44],
                            @[@"Python", @83],
                            @[@"OC"    , @11],
                            @[@"Ruby"  , @42],
                            @[@"PHP"   , @31],
                            @[@"Go"    , @63],
                            @[@"C"     , @24],
                            @[@"C#"    , @888],
                            @[@"C++"   , @66],
                            ]),
                 ]
               
               )
    ;
  • To draw a bubble chart,you should configure the properties of AAChartModel like this:
   AAChartModel *chartModel= AAObject(AAChartModel)
    .chartTypeSet(AAChartTypeBubble)
    .titleSet(@"THE HEAT OF PROGRAMMING LANGUAGE")
    .subtitleSet(@"Virtual Data")
    .yAxisTitleSet(@"Degrees Celsius")
    .seriesSet(
               @[
                 AAObject(AASeriesElement)
                 .nameSet(@"2017")
                 .dataSet(
                          @[
                            @[@97, @36, @79],
                            @[@94, @74, @60],
                            @[@68, @76, @58],
                            @[@64, @87, @56],
                            @[@68, @27, @73],
                            @[@74, @99, @42],
                            @[@7,  @93, @87],
                            @[@51, @69, @40],
                            @[@38, @23, @33],
                            @[@57, @86, @31]
                            ]),
                 
                 AAObject(AASeriesElement)
                 .nameSet(@"2018")
                 .dataSet(
                          @[
                            @[@25, @10, @87],
                            @[@2,  @75, @59],
                            @[@11, @54, @8 ],
                            @[@86, @55, @93],
                            @[@5,  @3,  @58],
                            @[@90, @63, @44],
                            @[@91, @33, @17],
                            @[@97, @3,  @56],
                            @[@15, @67, @48],
                            @[@54, @25, @81]
                            ]),
                 
                 AAObject(AASeriesElement)
                 .nameSet(@"2019")
                 .dataSet(
                          @[
                            @[@47, @47, @21],
                            @[@20, @12, @4 ],
                            @[@6,  @76, @91],
                            @[@38, @30, @60],
                            @[@57, @98, @64],
                            @[@61, @17, @80],
                            @[@83, @60, @13],
                            @[@67, @78, @75],
                            @[@64, @12, @10],
                            @[@30, @77, @82]
                            ]),
                 
                 ]
               )
    ;
  1. Supported chart type for now
typedef NSString *AAChartType;
static AAChartType const AAChartTypeColumn      = @"column";      //column chart
static AAChartType const AAChartTypeBar         = @"bar";         //bar chart 
static AAChartType const AAChartTypeArea        = @"area";        //area chart 
static AAChartType const AAChartTypeAreaspline  = @"areaspline";  //areaspline chart
static AAChartType const AAChartTypeLine        = @"line";        //line chart
static AAChartType const AAChartTypeSpline      = @"spline";      //spline chart
static AAChartType const AAChartTypeScatter     = @"scatter";     //scatter chart 
static AAChartType const AAChartTypePie         = @"pie";         //pie chart
static AAChartType const AAChartTypeBubble      = @"bubble";      //bubble chart  
static AAChartType const AAChartTypePyramid     = @"pyramid";     //pyramid chart
static AAChartType const AAChartTypeFunnel      = @"funnel";      //funnel chart
static AAChartType const AAChartTypeColumnrange = @"columnrange"; //columnrange chart
  1. Supported animation type for now
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,
};

Samples

  • line chart

IMG_1867.JPG

  • column chart

IMG_1873.JPG

  •   bar chart

IMG_1880.JPG

  • special area chart one

IMG_1869.JPG

  • special area chart two

IMG_1871.JPG

  • special area chart three

IMG_1863.JPG

  •   radar chart

IMG_1877.JPG

  •   polar chart

IMG_1879.JPG

  •   pie chart

IMG_1878.JPG

  • the oval style column chart

IMG_1866.JPG

  • bubble chart

IMG_1875.JPG

  • mixed chart

IMG_1882.JPG

AAChartModel:chart attribute list

AAPropStatementAndFuncStatement(copy,   AAChartModel, NSString *, title);
AAPropStatementAndFuncStatement(copy,   AAChartModel, NSString *, subtitle);

AAPropStatementAndFuncStatement(copy,   AAChartModel, AAChartSubtitleAlignType, subtitleAlign);
AAPropStatementAndFuncStatement(copy,   AAChartModel, AAChartType,              chartType);
AAPropStatementAndFuncStatement(copy,   AAChartModel, AAChartStackingType,      stacking);
AAPropStatementAndFuncStatement(copy,   AAChartModel, AAChartSymbolType,        symbol);
AAPropStatementAndFuncStatement(assign, AAChartModel, AAChartSymbolStyleType,   symbolStyle);

AAPropStatementAndFuncStatement(copy,   AAChartModel, AAChartZoomType,          zoomType);
AAPropStatementAndFuncStatement(assign, AAChartModel, AAChartAnimation,         animationType);

AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, animationDuration);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       inverted);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       xAxisReversed);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       yAxisReversed);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       crosshairs);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       gradientColorEnable);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       polar);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       dataLabelEnabled);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       xAxisLabelsEnabled);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSArray  *, categories);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, xAxisGridLineWidth);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       yAxisLabelsEnabled);
AAPropStatementAndFuncStatement(copy,   AAChartModel, NSString *, yAxisTitle);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, yAxisGridLineWidth);

AAPropStatementAndFuncStatement(strong, AAChartModel, NSArray     <NSString *>*, colorsTheme);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSArray  *, series);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       connectNulls);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       legendEnabled);

AAPropStatementAndFuncStatement(copy,   AAChartModel, NSString *, backgroundColor);
AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       options3dEnable);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, options3dAlpha);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, options3dBeta);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, options3dDepth);

AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, borderRadius);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, markerRadius);

AAPropStatementAndFuncStatement(assign, AAChartModel, BOOL,       yAllowDecimals);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSArray  *, yPlotLines);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, yMax);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSNumber *, yMin);
AAPropStatementAndFuncStatement(strong, AAChartModel, NSArray  *, yTickPositions);

More graphics

  • Note: The following DEMO picture is the GIF dynamic picture which is the size of 6M around, if there is no dynamic results because of that the picture resources are not loaded fully, please be patient to the picture resources before the contents of the fully loaded, then you will finally watch more of the dynamic demonstration of the project results.

image

Created By:

An An

                       _oo0oo_
                      o8888888o
                      88" . "88
                      (| -_- |)
                      0\  =  /0
                    ___/`---'\___
                  .' \\|     |// '.
                 / \\|||  :  |||// \
                / _||||| -:- |||||- \
               |   | \\\  -  /// |   |
               | \_|  ''\---/''  |_/ |
               \  .-\__  '-'  ___/-. /
             ___'. .'  /--.--\  `. .'___
          ."" '<  `.___\_<|>_/___.' >' "".
         | | :  `- \`.;`\ _ /`;.`/ - ` : | |
         \  \ `_.   \_ __\ /__ _/   .-` /  /
     =====`-.____`.___ \_____/___.-`___.-'=====
                       `=---='
*******************************************************
     ¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥
         €€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€
               $$$$$$$$$$$$$$$$$$$$$$$  
                   BUDDHA_BLESS_YOU       
                      AWAY_FROM
                         BUG

LICENSE

AAChartKit is available under the MIT license. See the LICENSE file for more information.

Contact

Postscript

If you want to shrink the size of the AAChartKit lib ,you should do something like this:

  1. Delete the .js file of AAJSFiles folder in AAChartKit,The names of multiple files that need to be deleted are as follows
  • AAJQueryLibrary.js
  • AAHighchartsLibrary.js
  • AAHighchartsMore.js
  • AAHighcharts-3d.js
  • AAFunnel.js

2.Change the content of AAChartView.html file

<script src="AAJQueryLibrary.js">
</script>
<script src="AAHighchartsLibrary.js">
</script>
<script src="AAHighchartsMore.js">
</script>
<script src="AAHighcharts-3d.js">
</script>
<script src="AAFunnel.js">
</script>

to be

<script src="https://img.hcharts.cn/jquery/jquery-1.8.3.min.js">
</script>
<script src="https://img.hcharts.cn/highcharts/highcharts.js">
</script>
<script src="https://img.hcharts.cn/highcharts/highcharts-more.js">
</script>

To-Do list

    • Support user to add delegate events after the graphics content loading was completed
    • Support graphics to refresh global content dynamically
    • Support graphics to refresh pure data (series) content dynamically
    • Support graphics to refresh pure data in real time and scroll dynamically
    • Support color layer gradient effects
    • Support 3D graphics effects, valid only for partial graphics such as column chart、bar chart、pie charts、scatterplot chart、bubble chart, etc.
    • Support CocoaPods
    • Support Carthage
    • Support code coverage test
    • Support horizontal screen (full screen) effect
    • Support setting graphics rendering animation freely
    • Support rendered graphics to generate image files
    • Support generating image files saved to the system album
    • Support user to configure AAOptions model object properties freely
    • Support stacking the graphics
    • Support reversing the graphics axis
    • Support rendering scatter chart
    • Support rendering column range map
    • Support rendering area range graph
    • Support rendering the polar chart
    • Support rendering the polyline straight line chart
    • Support rendering the polyline straight area chart
    • Support rendering the Nightingale rose 🌹chart
    • Support rendering the rectangular tree hierarchy diagrams
    • Support rendering the circular progress bar chart
    • Support adding clicked event callbacks for graphics

aachartkit's People

Contributors

aachartmodel avatar xiongoahc avatar irshadpc avatar

Watchers

James Cloos avatar avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.