AAInfographics

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

There is the link ofObjective-C version ofAAChartKit as follow

https://github.com/AAChartModel/AAChartKit

Preface

Features

Appreciation

Installation

CocoaPods (recommended)

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

Carthage

github"https://github.com/AAChartModel/AAChartKit-Swift.git" ~>1.0

Manually (old school way)

Usage

letchartViewWidth=self.view.frame.size.widthletchartViewHeight=self.view.frame.size.height        aaChartView=AAChartView()        aaChartView?.frame=CGRect(x:0,                                    y:60,                                    width: chartViewWidth,                                    height: chartViewHeight)        // set the content height of aachartView        // aaChartView?.contentHeight = self.view.frame.size.heightself.view.addSubview(aaChartView!)

letaaChartModel=AAChartModel().chartType(.area)//Can be any of the chart types listed under `AAChartType`..animationType(.bounce).title("TITLE")//The chart title.subtitle("subtitle")//The chart subtitle.dataLabelsEnabled(false) //Enable or disable the data labels. Defaults to false.tooltipValueSuffix("USD")//the value suffix of the chart tooltip.categories(["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"]).colorsTheme(["#fe117c","#ffc069","#06caf4","#7dffc0"]).series([AASeriesElement().name("Tokyo").data([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().name("New York").data([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().name("Berlin").data([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().name("London").data([3.9,4.2,5.7,8.5,11.9,15.2,17.0,16.6,14.2,10.3,6.6,4.8]),])

        //The chart view object calls the instance object of AAChartModel and draws the final graphic        aaChartView?.aa_drawChartWithChartModel(aaChartModel!)

Update chart content

        //Only refresh the chart series data        aaChartView?.aa_onlyRefreshTheChartDataWithChartModelSeries(chartModelSeriesArray)

        //Refresh the chart after the AAChartModel whole content is updated        aaChartView?.aa_refreshChartWholeContentWithChartModel(aaChartModel!)

Infographics sample

More graphics

Special instructions

Support user click events and move over events

 //Set AAChartView events delegate aaChartView!.delegate=selfasAAChartViewDelegate  //implement AAChartView user click or finger move over events delegate functionextensionBasicChartVC:AAChartViewDelegate{openfunc aaChartView(_ aaChartView:AAChartView, clickEventMessage:AAClickEventMessageModel){print("""            clicked point series element name:\(clickEventMessage.name??"")            🖱🖱🖱WARNING!!!!!!!!!!!!!!!!!!!! Click Event Message !!!!!!!!!!!!!!!!!!!! WARNING🖱🖱🖱            ==========================================================================================            ------------------------------------------------------------------------------------------            user finger moved over!!!,get the move over event message: {            category =\(String(describing: clickEventMessage.category))            index =\(String(describing: clickEventMessage.index))            name =\(String(describing: clickEventMessage.name))            offset =\(String(describing: clickEventMessage.offset))            x =\(String(describing: clickEventMessage.x))            y =\(String(describing: clickEventMessage.y))            }            +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++""")}openfunc aaChartView(_ aaChartView:AAChartView, moveOverEventMessage:AAMoveOverEventMessageModel){print("""            moved over point series element name:\(moveOverEventMessage.name??"")            ✋🏻✋🏻✋🏻✋🏻✋🏻WARNING!!!!!!!!!!!!!! Move Over Event Message !!!!!!!!!!!!!! WARNING✋🏻✋🏻✋🏻✋🏻✋🏻            ==========================================================================================            ------------------------------------------------------------------------------------------            user finger moved over!!!,get the move over event message: {            category =\(String(describing: moveOverEventMessage.category))            index =\(String(describing: moveOverEventMessage.index))            name =\(String(describing: moveOverEventMessage.name))            offset =\(String(describing: moveOverEventMessage.offset))            x =\(String(describing: moveOverEventMessage.x))            y =\(String(describing: moveOverEventMessage.y))            }            +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++""")}}

publicclassAAEventMessageModel:NSObject{publicvarname:String?publicvarx:Float?publicvary:Float?publicvarcategory:String?publicvaroffset:[String:Any]?publicvarindex:Int?}publicclassAAClickEventMessageModel:AAEventMessageModel{}publicclassAAMoveOverEventMessageModel:AAEventMessageModel{}

Support for customizing the style of chartAATooltip throughJavaScript function

aaOptions.tooltip?.useHTML(true).formatter("""function(){return' 🌕 🌖 🌗 🌘 🌑 🌒 🌓 🌔 <br/> '+' Support JavaScript Function Just Right Now !!! <br/> '+' The Gold Price For <b>2020 '+this.x+' </b> Is <b> '+this.y+' </b> Dollars ';}""").valueDecimals(2)//设置取值精确到小数点后几位//设置取值精确到小数点后几位.backgroundColor("#000000").borderColor("#000000").style(AAStyle().color("#FFD700").fontSize(12))

aaOptions.tooltip?.useHTML(true).formatter(#"""function(){letwholeContentStr='<span style=\"'+'color:lightGray; font-size:13px\"'+'>◉ Time: '+this.x+' year</span><br/>';letlength=this.points.length;for(leti=0;i<length;i++){letthisPoint=this.points[i];letyValue=thisPoint.y;if(yValue!=0){letspanStyleStartStr='<span style=\"'+'color:'+thisPoint.color+'; font-size:13px\"'+'>◉ ';letspanStyleEndStr='</span> <br/>';wholeContentStr+=spanStyleStartStr+thisPoint.series.name+': '+thisPoint.y+'℃'+spanStyleEndStr;}}returnwholeContentStr;}"""#).backgroundColor("#050505").borderColor("#050505")

Support value range segmentation

Support scrolling update chart data

Support data sorting with animation effect

Supported chart type for now

publicenumAAChartType:String{case column          //Column series display one column per value along an X axis.case bar             //A bar series is a special type of column series where the columns are horizontal.case area            //The area series type.case areaspline      //The area spline series is an area series where the graph between the points is smoothed into a spline.case line            //A line series displays information as a series of data points connected by straight line segments.case spline          //A spline series is a special type of line series, where the segments between the data points are smoothed.case scatter         //A scatter plot uses cartesian coordinates to display values for two variables for a set of data.case pie             //A pie chart is a circular graphic which is divided into slices to illustrate numerical proportion.case bubble          //A bubble series is a three dimensional series type where each point renders an X, Y and Z value. Each points is drawn as a bubble where the position along the X and Y axes mark the X and Y values, and the size of the bubble relates to the Z value.case packedbubble    //A packed bubble series is a two dimensional series type, where each point renders a value in X, Y position. Each point is drawn as a bubble where the bubbles don't overlap with each other and the radius of the bubble relates to the value.case pyramid         //A pyramid series is a special type of funnel, without neck and reversed by default.case funnel          //Funnel charts are a type of chart often used to visualize stages in a sales project, where the top are the initial stages with the most clients. It requires that the modules/funnel.js file is loaded.case columnpyramid   //Column pyramid series display one pyramid per value along an X axis. To display horizontal pyramids, set chart.inverted to true.case columnrange     //The column range is a cartesian series type with higher and lower Y values along an X axis. To display horizontal bars, set chart.inverted to true.case arearange       //The area range series is a cartesian series with higher and lower values for each point along an X axis, where the area between the values is shaded.case areasplinerange //The area spline range is a cartesian series type with higher and lower Y values along an X axis. The area inside the range is colored, and the graph outlining the area is a smoothed spline.case boxplot         //A box plot is a convenient way of depicting groups of data through their five-number summaries: the smallest observation (sample minimum), lower quartile (Q1), median (Q2), upper quartile (Q3), and largest observation (sample maximum).case waterfall       //A waterfall chart displays sequentially introduced positive or negative values in cumulative columns.case polygon         //A polygon series can be used to draw any freeform shape in the cartesian coordinate system. A fill is applied with the color option, and stroke is applied through lineWidth and lineColor options.case gauge           //Gauges are circular plots displaying one or more values with a dial pointing to values along the perimeter.case errorbar        //Error bars are a graphical representation of the variability of data and are used on graphs to indicate the error, or uncertainty in a reported measurement.}

Supported zoom gesture types for now

enumAAChartZoomType:String{case none="none"case x="x"case y="y"case xy="xy"}

Suppported line dash style types for now

publicenumAAChartLineDashStyleType:String{case solid           //———————————————————————————————————case shortDash       //— — — — — — — — — — — — — — — — — —case shortDot        //ⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈⵈcase shortDashDot    //—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧—‧case shortDashDotDot //—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧—‧‧case dot             //‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧‧case dash            //—— —— —— —— —— —— —— —— —— —— —— ——case longDash        //——— ——— ——— ——— ——— ——— ——— ——— ———case dashDot         //——‧——‧——‧——‧——‧——‧——‧——‧——‧——‧——‧——‧case longDashDot     //———‧———‧———‧———‧———‧———‧———‧———‧———‧case longDashDotDot  //———‧‧———‧‧———‧‧———‧‧———‧‧———‧‧———‧‧}

Supported animation type for now

publicenumAAChartAnimationType:String{case easeInQuad="easeInQuad"case easeOutQuad="easeOutQuad"case easeInOutQuad="easeInOutQuad"case easeInCubic="easeInCubic"case easeOutCubic="easeOutCubic"case easeInOutCubic="easeInOutCubic"case easeInQuart="easeInQuart"case easeOutQuart="easeOutQuart"case easeInOutQuart="easeInOutQuart"case easeInQuint="easeInQuint"case easeOutQuint="easeOutQuint"case easeInOutQuint="easeInOutQuint"case easeInSine="easeInSine"case easeOutSine="easeOutSine"case easeInOutSine="easeInOutSine"case easeInExpo="easeInExpo"case easeOutExpo="easeOutExpo"case easeInOutExpo="easeInOutExpo"case easeInCirc="easeInCirc"case easeOutCirc="easeOutCirc"case easeInOutCirc="easeInOutCirc"case easeOutBounce="easeOutBounce"case easeInBack="easeInBack"case easeOutBack="easeOutBack"case easeInOutBack="easeInOutBack"case elastic="elastic"case swingFromTo="swingFromTo"case swingFrom="swingFrom"case swingTo="swingTo"case bounce="bounce"case bouncePast="bouncePast"case easeFromTo="easeFromTo"case easeFrom="easeFrom"case easeTo="easeTo"}

About AAChartModel

publicclassAAChartModel:AAObject{publicvaranimationType:AAChartAnimationType? //The type of chart animationpublicvaranimationDuration:Int?      //The chart rendering animation durationpublicvartitle:String?               //The chart titlepublicvartitleStyle:AAStyle?         //The chart title stylepublicvarsubtitle:String?            //The chart subtitlepublicvarsubtitleAlign:AAChartAlignType?//The chart subtitle text align stylepublicvarsubtitleStyle:AAStyle?      //The chart subtitle stylepublicvarchartType:AAChartType?      //The default series type for the chart. Can be any of the chart types listed under `AAChartType`. Defaults to linepublicvarstacking:AAChartStackingType? //Whether to stack the values of each series on top of each other. Possible values are null to disable, "normal" to stack by value or "percent". When stacking is enabled, data must be sorted in ascending X orderpublicvarmarkerSymbol:AAChartSymbolType?   //A predefined shape or symbol for the marker. When null, the symbol is pulled from options.symbols. Other possible values are "circle", "square", "diamond", "triangle" and "triangle-down"publicvarmarkerSymbolStyle:AAChartSymbolStyleType?publicvarzoomType:AAChartZoomType?   //Decides in what dimensions the user can zoom by dragging the mouse. Can be one of x, y or xypublicvarinverted:Bool?              //Whether to invert the axes so that the x axis is vertical and y axis is horizontal. When true, the x axis is reversed by default. If a bar series is present in the chart, it will be inverted automatically.Inverting the chart doesn't have an effect if there are no cartesian series in the chart, or if the chart is polar.Defaults to falsepublicvarxAxisReversed:Bool?         //Whether to reverse the axis so that the highest number is closest to the origin. If the chart is inverted, the x axis is reversed by default. Defaults to falsepublicvaryAxisReversed:Bool?         //Whether to reverse the axis so that the highest number is closest to the origin. If the chart is inverted, the x axis is reversed by default. Defaults to falsepublicvarpolar:Bool?                 //When true, cartesian charts like line, spline, area and column are transformed into the polar coordinate system. Requires `AAHighchartsMore.js`. Defaults to falsepublicvarmargin:[Any?]?publicvardataLabelsEnabled:Bool?     //Enable or disable the data labels. Defaults to falsepublicvardataLabelsStyle:AAStyle?    //The data labels stylepublicvarxAxisLabelsEnabled:Bool?    //Enable or disable the axis labels. Defaults to truepublicvarxAxisLabelsStyle:AAStyle?   //The x axis labels stylepublicvarcategories:[String]?        //Set new categories for the axispublicvarxAxisGridLineWidth:Float?   //The width of the grid lines extending the ticks across the plot area.Defaults to 0publicvarxAxisVisible:Bool?          //Show the x axis or notpublicvarxAxisTickInterval:Float?    //Custom x axis tick interval,It is useful when the x categories array is too long to show all of thempublicvaryAxisVisible:Bool?          //Show the y axis or notpublicvaryAxisLabelsEnabled:Bool?    //Enable or disable the axis labels. Defaults to truepublicvaryAxisLabelsStyle:AAStyle?   //The y axis labels stylepublicvaryAxisTitle:String?          //The actual text of the axis titlepublicvarxAxisTitle:String?          //The actual text of the axis titlepublicvaryAxisLineWidth:Float?       //The width of y axis linepublicvaryAxisGridLineWidth:Float?   //The width of the grid lines extending the ticks across the plot area. Defaults to 1publicvaryAxisMin:Double?            //The y axis mini valuepublicvaryAxisMax:Double?            //The y axis max valuepublicvaryAxisTickPositions:[Any]?    //An array defining where the ticks are laid out on the axis. This overrides the default behaviour of tickPixelInterval and tickInterval.publicvaryAxisAllowDecimals:Bool?    //The y axis values label allow decimals or notpublicvartooltipEnabled:Bool?        //Show the tooltip or notpublicvartooltipValueSuffix:String?  //Custom tooltip value unit suffixpublicvarcolorsTheme:[Any]?          //An array containing the default colors for the chart's series. When all colors are used, new colors are pulled from the start again. Defaults to: ["#bb250c","#f67210","#fde680","#257679","#f1c6c5"]publicvarseries:[Any]?               //An array of all the chart's seriespublicvarlegendEnabled:Bool?         //Enable or disable the legend. Defaults to truepublicvarbackgroundColor:Any?        //The background color or gradient for the outer chart area. Defaults to #FFFFFFpublicvarborderRadius:Float?         //The corner radius of the outer chart border. Defaults to 0publicvarmarkerRadius:Float?         //The radius of the point marker. Defaults to 4publicvarscrollablePlotArea:AAScrollablePlotArea?    //Scroll properties if supported......}

Created By

"CODE IS FAR AWAY FROM BUG WITH THE ANIMAL PROTECTING"  *          ##2      ##2 *       ┏-##1　  ┏-##1 *    ┏_┛ ┻---━┛_┻━━┓ *    ┃　　　        ┃　　　　  *    ┃　　 ━　      ┃　　　  *    ┃@^　@^    ┃　　  *    ┃　　　　　　  ┃ *    ┃　　 ┻　　　 ┃ *    ┃_　　　　　 _┃ *     ┗━┓　　　┏━┛ *    　　┃　　　┃神兽保佑 *    　　┃　　　┃永无BUG！ *    　　┃　　　┗━━━┓----| *    　　┃　　　　　　　  ┣┓}}} *    　　┃　　　　　　　  ┏┛ *    　　┗┓&&&┓-┏&&&┓┏┛-| *    　　　┃┫┫　 ┃┫┫ *    　　　┗┻┛　 ┗┻┛ * *"CODE IS FAR AWAY FROM BUG WITH THE ANIMAL PROTECTING"

Source Code Links⛓

Normal Versions

Pro Versions

LICENSE

Contact

Todo list