AAInfographics,是 AAChartKit 的 swift語言版本,是在流行的開源前端圖表框架Highcharts的基礎上,封裝的面向對象的,壹組簡單易用,極其精美的圖表繪制控件.可能是這個星球上 UI 最精致的第三方 iOS 開源圖表框架了(✟我以無神論者的名義向上帝起誓🖐,我真的沒有在說鬼話✟)
- 環境友好,兼容性強. 適配
iOS 8 +, 支持ARC,支持swift語言,配置簡單.同時更有 Objective-C 版本AAChartKit可供使用. - 功能強大,類型多樣. 支持
柱狀圖、條形圖、折線圖、曲線圖、折線填充圖、曲線填充圖、雷達圖、極地圖、扇形圖、氣泡圖、散點圖、區域範圍圖、柱形範圍圖、面積範圍圖、面積範圍均線圖、直方折線圖、直方折線填充圖、箱線圖、瀑布圖、熱力圖、桑基圖、金字塔圖、漏鬥圖、等二十幾種類型的圖形,不可謂之不多. - 交互式圖形動畫. 有著清晰和充滿細節的用戶交互方式,與此同時,圖形渲染
動畫效果細膩精致,流暢優美.有三十多種以上渲染動畫效果可供選擇,用戶可自由設置渲染圖形時的動畫時間和動畫類型,關於圖形渲染動畫類型,具體參見 AAInfographics 動畫類型. - 支持手勢縮放.支持圖表的手勢縮放和拖動閱覽,手勢縮放類型具體參見 AAInfographics 手勢縮放類型,默認禁用手勢縮放功能.
- 極簡主義.
AAChartView + AAChartModel = Chart,在 AAInfographics 數據可視化圖形框架當中,遵循這樣壹個極簡主義公式:圖表視圖控件 + 圖表模型 = 妳想要的圖表.同另壹款強大、精美而又易用的開源圖形框架 AAChartKit完全壹致. - 鏈式編程語法. 支持類 Masonry
鏈式編程語法,壹行代碼即可配置完成AAChartModel模型對象實例. - 簡潔清晰,輕便易用. 最少僅僅需要 五行代碼 即可完成整個圖表的繪制工作(使用鏈式編程語法配置
AAChartModel實例對象時,無論妳寫多少行代碼,理論上只能算作是壹行). 😜😜😜 - 支持點擊事件 支持監聽用戶交互事件,可在此基礎上實現雙表聯動乃至多表聯動,以及其他更多更復雜的自定義用戶交互效果.具體參見支持監聽用戶點擊事件及單指滑動事件
- 添加
pod 'AAInfographics', :git => 'https://github.com/AAChartModel/AAChartKit-Swift.git'到妳的 Podfile文件當中.
- 在終端中運行命令
pod installorpod update. - 導入頭文件
AAInfographics.
- 下載 Demo
AAInfographicsDemo - 將 Demo 中的名為
AAInfographics的文件夾拖入至妳的項目之中.
- 創建視圖AAChartView
CGFloat chartViewWidth = self.view.frame.size.width
CGFloat chartViewHeight = self.view.frame.size.height
aaChartView = AAChartView()
aaChartView?.frame = CGRect(x:0,y:0,width:chartViewWidth,height:chartViewHeight)
// 設置 aaChartView 的內容高度(content height)
// aaChartView?.contentHeight = self.view.frame.size.height
self.view.addSubview(aaChartView!)- 配置視圖模型AAChartModel
- 鏈式編程的方式配置 AAChartModel 模型對象屬性
let chartModel = AAChartModel()
.chartType(.column)//圖表類型
.title("城市天氣變化")//圖表主標題
.subtitle("2020年09月18日")//圖表副標題
.inverted(false)//是否翻轉圖形
.yAxisTitle("攝氏度")// Y 軸標題
.legendEnabled(true)//是否啟用圖表的圖例(圖表底部的可點擊的小圓點)
.tooltipValueSuffix("攝氏度")//浮動提示框單位後綴
.categories(["Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"])
.colorsTheme(["#fe117c","#ffc069","#06caf4","#7dffc0"])//主題顏色數組
.series([
AASeriesElement()
.name("東京")
.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("紐約")
.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("柏林")
.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("倫敦")
.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]),
])- 繪制圖形(創建 AAChartView 實例對象後,首次繪制圖形調用此方法)
/*圖表視圖對象調用圖表模型對象,繪制最終圖形*/
aaChartView?.aa_drawChartWithChartModel(aaChartModel)🌹🌹🌹 好了,至此,有關於繪制圖形的任務,壹切皆已經搞定!!! 妳將得到妳想要的任意圖形!!!
如果妳需要更新圖表內容,妳應該閱讀以下內容,根據妳的實際需要,選擇調用適合妳的函數
- 僅僅刷新圖形的
series數據內容(首次繪制圖形完成之後,後續刷新圖表數據均建議調用此方法)
/*僅僅更新了圖表的series數組數據,不改動圖表的其他內容*/
aaChartView?.aa_onlyRefreshTheChartDataWithChartModelSeries(chartModelSeriesArray)- 刷新圖形除數據屬性
series以外的其他屬性(首次繪制圖形完成之後,後續刷新圖表的屬性均建議調用此方法 註意:僅僅刷新圖形數據,則建議使用上面的👆aa_onlyRefreshTheChartDataWithChartModelSeries方法)
/*更新 AAChartModel 整體內容(如修改了圖表的類型,將 column chart 改為 area chart)之後,刷新圖表*/
aaChartView?.aa_refreshChartWholeContentWithChartModel(aaChartModel)
)
註意:如下的這幅DEMO演示圖為大小6M左右的GIF動態圖,如未顯示動態效果則說明圖片資源未全部加載。請耐心等待至圖片資源內容完全加載結束後，即可最終觀賞更多的項目的動態演示效果.
可通過給 AAChartView 實例對象設置代理方法,來實現監聽用戶的點擊事件和單指滑動事件
//設置 AAChartView 事件代理
aaChartView!.delegate = self as AAChartViewDelegate
//設置 AAChartModel 支持觸摸事件
aaChartModel = aaChartModel!.touchEventEnabled(true)
//實現對 AAChartView 事件代理的監聽
extension CommonChartVC: AAChartViewDelegate {
open func aaChartView(_ aaChartView: AAChartView, moveOverEventMessage: AAMoveOverEventMessageModel) {
print("🔥selected point series element name: \(moveOverEventMessage.name ?? "")")
}
}在監聽用戶交互事件時,獲取的事件信息AAMoveOverEventMessageModel共包含以下內容
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?
}有時系統默認的 tooltip 浮動提示框的顯示效果無法滿足使用者的特殊自定義要求,此時可以通過添加 AATooltip 的 headerFormat、footerFormat 和 pointFormat 的字符串屬性的HTML文本內容,來自定義浮動提示框的顯示內容,此三者可以勝任絕大數情況下的自定義浮動提示框 AATooltip 的任務.
如仍舊不能滿足需求,更可以通過 AATooltip 的 formatter 函數來實現視圖的特殊定制化 例如,如下配置 AATooltip 實例對象屬性
//custom tooltip style
let aaTooltip = AATooltip()
.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)
)
即可完成圖表的浮動提示框的特殊定制化.得到的自定義浮動提示框的視覺效果圖如下👇
-
添加
顏色帶🎀值域分割
-
添加
顏色線🧶值域分割
enum AAChartType: String {
case column = "column" //柱形圖
case bar = "bar" //條形圖
case area = "area" //折線區域填充圖
case areaspline = "areaspline" //曲線區域填充圖
case line = "line" //折線圖
case spline = "spline" //曲線圖
case scatter = "scatter" //散點圖
case pie = "pie" //扇形圖
case bubble = "bubble" //氣泡圖
case pyramid = "pyramid" //金字塔圖
case funnel = "funnel" //漏鬥圖
case columnrange = "columnrange" //柱形範圍圖
case arearange = "arearange" //折線區域範圍圖
case areasplinerange = "areasplinerange" //曲線區域範圍圖
case boxplot = "boxplot" //箱線圖
case waterfall = "waterfall" //瀑布圖
case polygon = "polygon" //多邊形圖
}enum AAChartZoomType: String {
case none = "none" //禁用圖表手勢縮放功能(默認禁用手勢縮放)
case x = "x" //支持圖表 X 軸橫向縮放
case y = "y" //支持圖表 Y 軸縱向縮放
case xy = "xy" //支持圖表等比例縮放
}NOTE:例如,設置了AAChartModel的縮放屬性zoomType為AAChartZoomType.X,並且將圖表進行了手勢放大之後,這時候如果想要左右滑動圖表,可以使用 雙指點按 屏幕中的AAChartView視圖區域進行 左右拖動 即可.同時屏幕的右上角會自動出現壹個標題為 "恢復縮放" 的按鈕,點擊恢復縮放,圖表大小和位置將會回歸到原初的樣式.
以下是AAInfographics其中十種圖表渲染動畫類型
| Back | Bounce | Circ | Cubic | Elastic |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| Expo | Quad | Quart | Quint | Sine |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| 屬性名稱 | 屬性類型 | 描述 | 取值範圍 |
|---|---|---|---|
| title | String | 圖表主標題 | 任意有效的字符串 |
| subtitle | String | 圖表副標題 | 任意有效的字符串 |
| chartType | AAChartType | 圖表類型,可以為AAChartType枚舉字符串當中指定的任意有效類型.其中有支持柱狀圖 、條形圖 、折線圖 、曲線圖 、折線填充圖 、曲線填充圖、雷達圖、扇形圖、氣泡圖、散點圖、金字塔圖、漏鬥圖、區域範圍圖、柱形範圍圖等多種圖形 |
.column, .bar, .area, .areaSpline, .line, .spline, .pie, .bubble, .scatter, .pyramid, .funnel, .areaRange, .columnRange |
| stacking | AAChartStackingType | 是否將圖表每個數據列的值疊加在壹起。 默認的值為.none， 即禁用堆疊樣式效果.另有常規堆疊樣式和百分比堆疊樣式可供選擇 |
.none, .normal, .percent |
| symbol | AAChartSymbolType | 預定義的圖表曲線連接點的樣式類型.其可供選擇的值有圓、正方形、鉆石、常規三角形和倒三角形,默認為混合樣式 |
.circle, .square, .diamond, .triangle, .triangleDown |
public var animationType: AAChartAnimationType? //動畫類型
public var animationDuration: Int? //動畫時間
public var title: String? //標題內容
public var titleFontColor: String? //標題字體顏色
public var titleFontSize: Float? //標題字體大小
public var titleFontWeight: AAChartFontWeightType? //標題字體粗細
public var subtitle: String? //副標題內容
public var subtitleAlign: String? //副標題文本水平對齊方式
public var subtitleFontColor: String? //副標題字體顏色
public var subtitleFontSize: Float? //副標題字體大小
public var subtitleFontWeight: AAChartFontWeightType? //副標題字體粗細
public var axesTextColor: String? //x 軸和 y 軸文字顏色
public var chartType: AAChartType? //圖表類型
public var stacking: AAChartStackingType? //堆積樣式
public var symbol: AAChartSymbolType? //折線曲線連接點的類型："circle", "square", "diamond", "triangle","triangle-down"，默認是"circle"
public var symbolStyle: AAChartSymbolStyleType? //折線或者曲線的連接點是否為空心的
public var zoomType: AAChartZoomType? //縮放類型 AAChartZoomTypeX表示可沿著 x 軸進行手勢縮放
public var inverted: Bool? //x 軸是否翻轉(垂直)
public var xAxisReversed: Bool? //x 軸翻轉
public var yAxisReversed: Bool? //y 軸翻轉
public var polar: Bool? //是否極化圖形(變為雷達圖)
public var marginLeft: Float? //圖表左邊距
public var marginRight: Float? //圖表右邊距
public var marginBottom: Float? //圖表底部邊距
public var dataLabelsEnabled: Bool? //數據標簽是否顯示
public var dataLabelsFontColor: String? //數據標簽的字體顏色
public var dataLabelsFontSize: Float? //數據標簽的字體大小
public var dataLabelsFontWeight: AAChartFontWeightType?//數據標簽的字體粗細
public var xAxisLabelsEnabled: Bool? //x 軸是否顯示數據
public var categories: [String]? //x 軸是否顯示數據
public var xAxisGridLineWidth: Float? //x 軸網格線的寬度
public var xAxisVisible: Bool? //x 軸是否顯示
public var xAxisTickInterval: Int? //x 軸刻度線間隔
public var yAxisVisible: Bool? //y 軸是否顯示
public var yAxisLabelsEnabled: Bool? //y 軸是否顯示數據
public var yAxisTitle: String? //y 軸標題
public var yAxisLineWidth: Float? //y 軸軸線的寬度
public var yAxisMin: Float? //y 軸起始位置的最小值
public var yAxisMax: Float? //y 軸結束位置的最大值
public var yAxisAllowDecimals: Bool? //y 軸是否允許小數
public var yAxisGridLineWidth: Float? //y 軸網格線的寬度
public var tooltipEnabled: Bool? //是否顯示浮動提示框(默認顯示)
public var tooltipValueSuffix: String? //浮動提示框單位後綴
public var tooltipCrosshairs: Bool? //是否顯示準星線(默認顯示)
public var colorsTheme: [Any]? //圖表主題顏色數組
public var series: [AASeriesElement]? //圖表的數據數組
public var legendEnabled: Bool? //是否顯示圖例
public var backgroundColor: Any? //圖表背景色
public var borderRadius: Int? //柱狀圖長條圖頭部圓角半徑(可用於設置頭部的形狀,僅對條形圖,柱狀圖有效)
public var markerRadius: Int? //折線連接點的半徑長度
public var touchEventEnabled: Bool? //是否支持觸摸事件回調
_oo0oo_
o8888888o
88" . "88
(| -_- |)
0\ = /0
___/`---'\___
.' \\| |// '.
/ \\||| : |||// \
/ _||||| -:- |||||- \
| | \\\ - /// | |
| \_| ''\---/'' |_/ |
\ .-\__ '-' ___/-. /
___'. .' /--.--\ `. .'___
."" '< `.___\_<|>_/___.' >' "".
| | : `- \`.;`\ _ /`;.`/ - ` : | |
\ \ `_. \_ __\ /__ _/ .-` / /
=====`-.____`.___ \_____/___.-`___.-'=====
`=---='
*******************************************************
¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥¥
€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€€
$$$$$$$$$$$$$$$$$$$$$$$
BUDDHA_BLESS_YOU
AWAY_FROM
BUG| 語言版本 | 項目名稱 | 適用平臺 | 源代碼鏈接 |
|---|---|---|---|
| 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 |
本項目 AAInfographics使用 MIT許可證,詳情請點擊MIT LICENSE
- 🌕 🌖 🌗 🌘 暖心提示 🌑 🌒 🌓 🌔
- 如果有任何使用上的問題,隨時歡迎您在 GitHub 上向我提 issue.
- GitHub Issues : https://github.com/AAChartModel/AAChartKit-Swift/issues
- 如果您想參與到此項目的開源活動中來,也同樣隨時歡迎您聯系我
- 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
- 支持圖形加載完成後用戶添加代理事件
- 支持圖形動態刷新全局內容
- 支持圖形動態刷新純數據
(series)內容 - 支持色彩圖層漸變效果
- 支持3D圖形效果,僅對
柱狀圖、條形圖、扇形圖、散點圖、氣泡圖等部分圖形有效 - 支持橫屏(全屏)效果
- 支持自由設置圖形渲染動畫
- 支持用戶自由配置
AAOptions模型對象屬性 - 支持圖形堆疊
- 支持圖形坐標軸反轉
- 支持渲染散點圖
- 支持渲染柱形範圍圖
- 支持渲染面積範圍圖
- 支持渲染面積範圍均線圖
- 支持渲染極地圖
- 支持渲染折線直方圖
- 支持渲染折線直方填充圖
- 支持渲染矩形樹狀層級關系圖
- 支持渲染活動刻度儀表圖
- 支持為圖形添加點擊事件回調
- 支持圖形實時刷新純數據並動態滾動
- 支持已渲染圖形生成圖片文件
- 支持生成圖片文件保存至系統相冊