AAInfographics

English Document 🇬🇧 | 简体中文文档 🇨🇳 | 繁體中文文檔 🇭🇰

There is the link of Objective-C version of `AAChartKit` as follow

https://github.com/AAChartModel/AAChartKit

Preface

AAInfographics is the Swift language version of AAChartKit which is object-oriented, a set of easy-to-use, extremely elegant graphics drawing controls,based on the popular open source front-end chart library Highcharts. It makes it very fast to add interactive charts to your mobile projects. It supports single touch-drag for data inspection, multi-touch for zooming, and advanced responsiveness for your apps .

Features

🎂 Environment friendly. Support iOS、iPadOS and macOS. Totally support Swift language, and there are more types version such as Objective-C language version AAChartKit 、 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 framework AAChartKit.
🖱 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.

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)

Add following content

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

to your project Podfile.

Run pod install or pod update.
Import AAInfographics.

Manually (old school way)

Download whole project demo of AAInfographicsDemo
Drag the folder AAInfographics into your project.

Usage

Creat the instance object of chart view:AAChartView

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

Configure the properties of chart model:AAChartModel

        let aaChartModel = AAChartModel()
            .chartType(.column)//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]),
                    ])

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
        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.

Only refresh the chart data(This method is recommended to be called for updating the series data dynamically)

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

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)

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

Infographics sample

line chart

column chart

bar chart

special area chart one

special area chart two

special area chart three

polar chart

radar chart

pie chart

bubble chart

scatter chart

arearange chart

step area chart

mixed chart

More graphics

Note: The following DEMO picture is a GIF dynamic picture which 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.

Special instructions

Support user click events and move over events

you can monitor the user touch events message through implementing delegate function for AAChartView instance object

 //Set AAChartView events delegate
 aaChartView!.delegate = self as AAChartViewDelegate
 //set AAChartModel support user touch event
 aaChartModel = aaChartModel!.touchEventEnabled(true)

 //implement AAChartView user touch events delegate function
extension CommonChartVC: AAChartViewDelegate {
   open func aaChartView(_ aaChartView: AAChartView, moveOverEventMessage: AAMoveOverEventMessageModel) {
       print("🔥selected point series element name: \(moveOverEventMessage.name ?? "")")
   }
}

The received touch events message contain following content

public class AAMoveOverEventMessageModel: NSObject {
    public var name: String?
    public var x: Float?
    public var y: Float?
    public var category: String?
    public var offset: [String: Any]?
    public var index: Int?
}

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

Support for custom the style of chart `AATooltip` through `JavaScript` function

As we all know, AAInfographics support using HTML String. Most of time, the headerFormat 、pointFormat、footerFormat HTML 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 through JavaScript function.

For example

configuring AATooltip instance object properties as follow:

         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)
        )

you can get the customized tooltip style chart like this👇

configuring AATooltip instance object properties as follow:

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

you can get the customized tooltip style chart like this👇

Support value range segmentation

chart with value range segmentation bands 🎀
chart with value range segmentation lines 🧶
chart with value range segmentation zones 🧱

Support scrolling update chart data

Support data sorting with animation effect

Supported chart type for now

enum AAChartType: String {
    case column          = "column"          //column chart
    case bar             = "bar"             //bar chart 
    case area            = "area"            //area chart 
    case areaspline      = "areaspline"      //areaspline chart
    case line            = "line"            //line chart
    case spline          = "spline"          //spline chart
    case scatter         = "scatter"         //scatter chart 
    case pie             = "pie"             //pie chart
    case bubble          = "bubble"          //bubble chart  
    case pyramid         = "pyramid"         //pyramid chart
    case funnel          = "funnel"          //funnel chart
    case columnrange     = "columnrange"     //column range chart
    case arearange       = "arearange"       //area range chart
    case areasplinerange = "areasplinerange" //area spline range chart
    case boxplot         = "boxplot"         //boxplot chart
    case waterfall       = "waterfall"       //waterfall chart
    case polygon         = "polygon"         //polygon chart
}

Supported zoom gesture types for now

enum AAChartZoomType: String {
    case none = "none"
    case x    = "x"
    case y    = "y"
    case xy   = "xy"
}

Supported animation type for now

 public enum AAChartAnimationType: 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"
}

Here are the ten concrete animation types of AAInfographics

Back	Bounce	Circ	Cubic	Elastic

Expo	Quad	Quart	Quint	Sine

About AAChartModel

AAChartModel:chart basic properties instruction

Property name	Property type	Description	Value Range
title	String	The chart title	Any valid string
subtitle	String	The chart subtitle	Any valid string
chartType	AAChartType	The default series type for the chart. Can be any of the chart types listed under `AAChartType`.	.column, .bar, .area, .areaSpline, .line, .spline, .pie, .bubble, .scatter, .pyramid, .funnel, .areaRange, .columnRange
stacking	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 order	.none, .normal, .percent
symbol	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"	.circle, .square, .diamond, .triangle, .triangleDown

AAChartModel:chart all properties list

public class AAChartModel: AAObject {
    public var animationType: AAChartAnimationType? //The type of chart animation
    public var animationDuration: Int?      //The chart rendering animation duration
    public var title: String?               //The chart title
    public var titleStyle: AAStyle?         //The chart title style
    public var subtitle: String?            //The chart subtitle
    public var subtitleAlign: AAChartAlignType?//The chart subtitle text align style
    public var subtitleStyle: AAStyle?      //The chart subtitle style
    public var axesTextColor: String?       //The labels font color of chart x axis and y axis
    public var chartType: AAChartType?      //The default series type for the chart. Can be any of the chart types listed under `AAChartType`. Defaults to line
    public var stacking: 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 order
    public var markerSymbol: 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"
    public var markerSymbolStyle: AAChartSymbolStyleType?
    public var zoomType: AAChartZoomType?   //Decides in what dimensions the user can zoom by dragging the mouse. Can be one of x, y or xy
    public var inverted: 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 false
    public var xAxisReversed: 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 false
    public var yAxisReversed: 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 false
    public var crosshairs: Bool?            //Enable or disable the crosshairs
    public var polar: Bool?                 //When true, cartesian charts like line, spline, area and column are transformed into the polar coordinate system. Requires `AAHighchartsMore.js`. Defaults to false
    public var margin: [Float]?
    public var dataLabelsEnabled: Bool?     //Enable or disable the data labels. Defaults to false
    public var dataLabelsStyle: AAStyle?    //The data labels style
    public var xAxisLabelsEnabled: Bool?    //Enable or disable the axis labels. Defaults to true
    public var categories: [String]?        //Set new categories for the axis
    public var xAxisGridLineWidth: Float?   //The width of the grid lines extending the ticks across the plot area.Defaults to 0
    public var xAxisVisible: Bool?          //Show the x axis or not
    public var xAxisTickInterval: Float?    //Custom x axis tick interval,It is useful when the x categories array is too long to show all of them
    public var yAxisVisible: Bool?          //Show the y axis or not
    public var yAxisLabelsEnabled: Bool?    //Enable or disable the axis labels. Defaults to true
    public var yAxisTitle: String?          //The actual text of the axis title
    public var xAxisTitle: String?          //The actual text of the axis title
    public var yAxisLineWidth: Float?       //The width of y axis line
    public var yAxisGridLineWidth: Float?   //The width of the grid lines extending the ticks across the plot area. Defaults to 1
    public var yAxisMin: Double?            //The y axis mini value
    public var yAxisMax: Double?            //The y axis max value
    public var yAxisAllowDecimals: Bool?    //The y axis values label allow decimals or not
    public var tooltipEnabled: Bool?        //Show the tooltip or not
    public var tooltipValueSuffix: String?  //Custom tooltip value unit suffix
    public var tooltipCrosshairs: Bool?     //Show tooltip crosshair or not
    public var colorsTheme: [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"]
    public var series: [Any]?               //An array of all the chart's series
    public var legendEnabled: Bool?         //Enable or disable the legend. Defaults to true
    public var backgroundColor: Any?        //The background color or gradient for the outer chart area. Defaults to #FFFFFF
    public var borderRadius: Float?         //The corner radius of the outer chart border. Defaults to 0
    public var markerRadius: Float?         //The radius of the point marker. Defaults to 4
    public var touchEventEnabled: Bool?     //Support touch event call back or not
    public var scrollablePlotArea: AAScrollablePlotArea?    //Scroll properties if supported
    ...
    ...  
}

Created By

An An

 "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

Language	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

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...

LICENSE

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

Contact

🌕 🌖 🌗 🌘 WARM TIPS!!! 🌑 🌒 🌓 🌔
Please contact me on GitHub,if there are any problems encountered in use.
GitHub Issues : https://github.com/AAChartModel/AAChartKit-Swift/issues

And if you want to contribute for this project, please contact me as well
GitHub : https://github.com/AAChartModel
StackOverflow : https://stackoverflow.com/users/7842508/codeforu
JianShu : http://www.jianshu.com/u/f1e6753d4254
SegmentFault : https://segmentfault.com/u/huanghunbieguan

Todo list

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

AAInfographics

English Document 🇬🇧 | 简体中文文档 🇨🇳 | 繁體中文文檔 🇭🇰

There is the link of Objective-C version of AAChartKit as follow

https://github.com/AAChartModel/AAChartKit

Preface

Features

Appreciation

Installation

CocoaPods (recommended)

Manually (old school way)

Usage

Update chart content

Infographics sample

line chart

column chart

bar chart

special area chart one

special area chart two

special area chart three

polar chart

radar chart

pie chart

bubble chart

scatter chart

arearange chart

step area chart

mixed chart